InsertElementAndSetValue(DicomElement,bool,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( 
   DicomElement element, 
   bool tree, 
   long tag, 
   object value 
)

Public Overloads Function InsertElementAndSetValue( _ 
   ByVal element As DicomElement, _ 
   ByVal tree As Boolean, _ 
   ByVal tag As Long, _ 
   ByVal value As Object _ 
) As DicomDataSet

public: 
DicomDataSet^ InsertElementAndSetValue(  
   DicomElement^ element, 
   bool tree, 
   int64 tag, 
   Object^ value 
)

Parameters

element
An item in the data set.

tree
true to evaluate the Data Set as a tree; false to evaluate the Data Set as a list.

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. After calling this method, the InsertElementAndSetValueResult property contains a value that indiciates the success of the method. For an example of how this can be used efficiently to create a DICOM sequence, see BeginEditSequence

Example

This example shows how to set the value of various DICOM elements, regardless of the DicomVRType or the multiplicity.

using Leadtools; 
using Leadtools.Dicom; 
 
 
///  
 
private void DicomDataSet_InsertElementAndSetValueExample() 
{ 
   DicomDataSet ds = new DicomDataSet(); 
 
   // Set a string 
   ds.InsertElementAndSetValue(null, false, DicomTag.PatientName, "Patient^Joe^MiddleName"); 
 
   // Or use an overload 
   ds.InsertElementAndSetValue(DicomTag.PatientName, "Patient^Joe^MiddleName"); 
 
   // This is how you check to see if the element got added -- for simplicity, we only check the first time 
   Console.WriteLine(ds.InsertElementAndSetValueResult.ToString()); 
 
   // Set an array of strings 
   string[] names = { "One", "Two", "Three" }; 
   ds.InsertElementAndSetValue(DicomTag.OtherPatientNames, names); 
 
   // Another way to do an array of strings 
   List<string> it = new List<string>(); 
   it.Add("ORIGINAL"); 
   it.Add("PRIMARY"); 
   ds.InsertElementAndSetValue(DicomTag.ImageType, it.ToArray()); 
 
   // Set an array of integers, that will be converted to strings 
   int[] namesInt = { 1, 2, 3 }; 
   ds.InsertElementAndSetValue(DicomTag.PhysicianOfRecord, namesInt); 
 
   // Set a DicomDateValue 
   DicomDateValue dicomDate = new DicomDateValue(1961, 6, 5); 
   ds.InsertElementAndSetValue(DicomTag.PatientBirthDate, dicomDate); 
 
   // Set a DateTime 
   DateTime dateTime = new DateTime(2003, 5, 16); 
   ds.InsertElementAndSetValue(DicomTag.InstanceCreationDate, dateTime); 
 
   // Set an array of DateTime 
   DateTime[] dateTimeArray = { new DateTime(2000, 3, 8), new DateTime(2003, 5, 16) }; 
   ds.InsertElementAndSetValue(DicomTag.DateOfLastCalibration, dateTimeArray); 
 
   ds.Save(Path.Combine(LEAD_VARS.ImagesDir, "test.dcm"), DicomDataSetSaveFlags.None); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Imports Leadtools 
Imports Leadtools.Dicom 
 
'''  
 
Private Sub DicomDataSet_InsertElementAndSetValueExample() 
   Dim ds As DicomDataSet = New DicomDataSet() 
 
   ' Set a string 
   ds.InsertElementAndSetValue(Nothing, False, DicomTag.PatientName, "Patient^Joe^MiddleName") 
 
   ' Or use an overload 
   ds.InsertElementAndSetValue(DicomTag.PatientName, "Patient^Joe^MiddleName") 
 
   ' This is how you check to see if the element got added -- for simplicity, we only check the first time 
   MessageBox.Show(ds.InsertElementAndSetValueResult.ToString()) 
 
   ' Set an array of strings 
   Dim names As String() = {"One", "Two", "Three"} 
   ds.InsertElementAndSetValue(DicomTag.OtherPatientNames, names) 
 
   ' Another way to do an array of strings 
   Dim it As List(Of String) = New List(Of String)() 
   it.Add("ORIGINAL") 
   it.Add("PRIMARY") 
   ds.InsertElementAndSetValue(DicomTag.ImageType, it.ToArray()) 
 
   ' Set an array of integers, that will be converted to strings 
   Dim namesInt As Integer() = {1, 2, 3} 
   ds.InsertElementAndSetValue(DicomTag.PhysicianOfRecord, namesInt) 
 
   ' Set a DicomDateValue 
   Dim dicomDate As DicomDateValue = New DicomDateValue(1961, 6, 5) 
   ds.InsertElementAndSetValue(DicomTag.PatientBirthDate, dicomDate) 
 
   ' Set a DateTime 
   Dim dateTime As DateTime = New DateTime(2003, 5, 16) 
   ds.InsertElementAndSetValue(DicomTag.InstanceCreationDate, dateTime) 
 
   ' Set an array of DateTime 
   Dim dateTimeArray As DateTime() = {New DateTime(2000, 3, 8), New DateTime(2003, 5, 16)} 
   ds.InsertElementAndSetValue(DicomTag.DateOfLastCalibration, dateTimeArray) 
 
   ds.Save(Path.Combine(LEAD_VARS.ImagesDir, "test.dcm"), DicomDataSetSaveFlags.None) 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class