BinaryValues2 property (ILEADDicomDS)

Remarks

Gets or sets a byte array retrieved from or set to the Data Element specified by the CurrentElement property. The size of this array is determined by the BinaryValueCount property.

If you are retrieving binary values associated with the element specified in the CurrentElement property, calling the GetBinaryValue method updates this property with the binary values associated with the specified element.

If you are setting binary values associated with the element specified in the CurrentElement property by calling SetBinaryValue method, setting this property will automatically update the BinaryValueCount property.

The data type of this property is byte array, which makes accessing the data faster than the existing BinaryValues property, other than that, both properties are identical.

After calling the GetBinaryValue method to retrieve the binary data of an element, both the BinaryValues and BinaryValues2 properties will have the same data, but give the user different ways to access that data.

It is strongly recommended that you not use this property and the BinaryValues property in the same section of code. However, if they are used in the same section of code, the order in which these properties are used is important. The last property set will control the values used when you call the SetBinaryValue method.

Set the BinaryValueCount property to 0 at any time to free the memory used for both the BinaryValues and BinaryValues2 properties.

See Also