GetBinaryValue(DicomElement,int) Method

Summary

Gets the binary value of the specified data element.

Syntax

C++

Java

public byte[] GetBinaryValue( 
   DicomElement element, 
   int length 
)

Public Overloads Function GetBinaryValue( _ 
   ByVal element As DicomElement, _ 
   ByVal length As Integer _ 
) As Byte()

public byte[] getBinaryValue(DicomElement element, int length)

public: 
array<byte>^ GetBinaryValue(  
   DicomElement^ element, 
   int length 
)

Parameters

element
An item in the Data Set.

length
Number of bytes, from the binary value, to retrieve.

Return Value

Buffer that contains the binary value associated with the specified item in the Data Set, or null if the method couldn't get the binary value.

Remarks

If the length specified by the DicomElement.Length property is greater than [length](" id="lengthparameterlink" class="popuplink.html), then the binary value returned will be truncated to the smaller length. If the length specified by DicomElement.Length is less than [length](" id="lengthparameterlink" class="popuplink.html), then the entire binary value of element will be returned. This method can be called for every Value Representation, and it will return the exact value in the Value Field (unconverted).

Example

For an example, refer to SetIntValue.

Requirements

Target Platforms