'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)

public void Add( 
   int Group,
   int Element,
   string VR,
   object Value
)

public:
void Add( 
   int Group,
   int Element,
   String^ VR,
   Object^ 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

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.

Target Platforms: .NET CLR 4.0 or higher