ValueLength Property

Summary

Gets the byte offset of the value of the element

Syntax

Objective-C

C++/CLI

public long ValueLength { get; }

@property (nonatomic, assign, readonly) NSUInteger valueLength;

public: 
property int64 ValueLength { 
   int64 get(); 
}

Property Value

The byte offset of the value of the element

Remarks

Depending on the transfer syntax and value representation, a DICOM Element is stored in a file as one of the following

Tag(4 bytes), VR(4 bytes), Value Length (4 bytes), Value
Tag(4 bytes), VR(2 bytes), Value Length (2 bytes), Value
Tag(4 bytes), Value Length (4 bytes), Value

The ValueOffset property returns the byte offset for the Value DicomElement in the file. If you seek to this offset in the DICOM file, the next ValueLength bytes will be the value of the DICOM element. Note that for sequences, ValueLength also includes the length of all the items and DICOM Elements in each items. This means that if you seek to (ValueOffset + ValueLength), you will be at the next element at the end of the sequence.

Requirements

Target Platforms