DicomObjects.NET8 Documentation
DicomObjects Namespace / DicomImage Class / Add Method / Add(Int32,Int32,Object) Method

The group index of a data element.

The element index of a data element.

The Value to be assigned




In This Topic
    Add(Int32,Int32,Object) Method
    In This Topic
    Creates and adds standard data elements to the underlying DicomDataSet
    Syntax
    'Declaration
     
    
    Public Overloads Sub Add( _
       ByVal Group As Integer, _
       ByVal Element As Integer, _
       ByVal Value As Object _
    ) 
    'Usage
     
    
    Dim instance As DicomImage
    Dim Group As Integer
    Dim Element As Integer
    Dim Value As Object
     
    instance.Add(Group, Element, Value)
    public void Add( 
       int Group,
       int Element,
       object Value
    )
    public:
    void Add( 
       int Group,
       int Element,
       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

    Remarks

    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.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also