InsertElementAndSetValue(long,object) Method

Summary

Finds or inserts (if not found) an element in the data set and sets the value of the element.

Syntax

C++

public DicomDataSet InsertElementAndSetValue( 
   long tag, 
   object value 
)

Public Overloads Function InsertElementAndSetValue( _ 
   ByVal tag As Long, _ 
   ByVal value As Object _ 
) As DicomDataSet

public: 
DicomDataSet^ InsertElementAndSetValue(  
   int64 tag, 
   Object^ value 
)

Parameters

tag
Tag of the item to find or insert.

value
value to insert

Return Value

A reference to the DicomDataSet class (a 'this' pointer)

Remarks

This method is used to set the value of an existing DICOM data set element, or if the existing element does not already exist, to insert the element and then set its value. The value parameter can be any supported DICOM value. For details on the value parameter, see SetValue

This method returns a reference to the DicomDataSet class so that it can be used as part of a 'fluent' interface. For an example of how this can be used efficiently to create a DICOM sequence, see BeginEditSequence

Example

For an example, refer to InsertElementAndSetValue.

Requirements

Target Platforms