DicomObjects.NetStandard Documentation
DicomObjects Namespace / DicomDataSet Class / Add Method / Add(Int32,Int32,String,Object) Method

The group index of a data element.

The element index of a data element.

The value representation (2 character string) of the data element to be added

The Value to be assigned




Add(Int32,Int32,String,Object) Method
Creates and adds standard data elements with specified VR to DicomDataSet
Syntax
'Declaration
 
Public Overloads Sub Add( _
   ByVal Group As Integer, _
   ByVal Element As Integer, _
   ByVal VR As String, _
   ByVal Value As Object _
) 
 
'Usage
 
Dim instance As DicomDataSet
Dim Group As Integer
Dim Element As Integer
Dim VR As String
Dim Value As Object
 
instance.Add(Group, Element, VR, Value)

Parameters

Group

The group index of a data element.

Element

The element index of a data element.

VR

The value representation (2 character string) of the data element to be added

Value

The Value to be assigned

Remarks

This method is to explicitly add elements with specified VR. The type of value required for the "Value" parameter depends on the value representation of the data element, as defined by either by the VR parameter. Values of the types are always acceptable, as are values of other types that can be suitably coerced. Variants of type "null" are also accepted, resulting a zero-length data element, which can be useful in raw queries and for �type 2� elements. There are some special conditions relating to date and time types.

To create a sequence, value may be a DicomDataSetCollection.

If the data element being added has a potential value multiplicity (VM) of >1, then value may be either an array or scalar, but if the element�s VM is always 1, then an attempt to assign an array will generate an error.

Any existing data element with the same group and element will be silently replaced, even if it is an array.

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