'Declaration
 
Public Overloads Sub Add( _
   ByVal Group As System.Integer, _
   ByVal Element As System.Integer, _
   ByVal Value As System.Object _
) 

'Usage
 
Dim instance As DicomImage
Dim Group As System.Integer
Dim Element As System.Integer
Dim Value As System.Object
 
instance.Add(Group, Element, Value)

public void Add( 
   System.int Group,
   System.int Element,
   System.object Value
)

public procedure Add( 
    Group: System.Integer;
    Element: System.Integer;
    Value: System.TObject
); 

public function Add( 
   Group : System.int,
   Element : System.int,
   Value : System.Object
);

public: void Add( 
   System.int Group,
   System.int Element,
   System.Object* Value
) 

public:
void Add( 
   System.int Group,
   System.int Element,
   System.Object^ Value
) 

Parameters

Group

The group index of a data element.

Element

The element index of a data element.

Value

The Value to be assigned

This method can read either official "Part10" format files with the 128 byte header, or unofficial "Part5" format files without a header. Detection of the type is automatic.

The file may have been written by the Write method or by other DICOM software.

By default, pixel data is read only when it is required, greatly speeding the display of multi-frame images, and reducing memory requirements. However, a side effect of this is that any elements after the pixel data (7FE0,0010) will not be read. This should not affect most applications, but if necessary, this behavior may be over-ridden using the CloseFilesAfterReading property.

Another effect of file mapping is that files read using this method cannot be deleted until the image object is released. This method creates two references to the newly created DicomImage object (one in the collection, and one as the return value), and both must be released before the file can be deleted.

Target Platforms: .NET CLR 4.8 or higher