BeginEditSequence(DicomElement,Boolean,Int64) Method

public DicomDataSet BeginEditSequence( 
   DicomElement element,
   bool tree,
   long tag
)

'Declaration
 
Public Overloads Function BeginEditSequence( _
   ByVal element As DicomElement, _
   ByVal tree As Boolean, _
   ByVal tag As Long _
) As DicomDataSet

'Usage
 
Dim instance As DicomDataSet
Dim element As DicomElement
Dim tree As Boolean
Dim tag As Long
Dim value As DicomDataSet
 
value = instance.BeginEditSequence(element, tree, tag)

public DicomDataSet BeginEditSequence( 
   DicomElement element,
   bool tree,
   long tag
)

ObjectiveC Syntax

 function Leadtools.Dicom.DicomDataSet.BeginEditSequence(DicomElement,Boolean,Int64)( 
   element ,
   tree ,
   tag 
)

public:
DicomDataSet^ BeginEditSequence( 
   DicomElement^ element,
   bool tree,
   int64 tag
) 

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 number of the DICOM element sequence

Return Value

This method is used to begin editing an existing DICOM sequence, or to create a new DICOM sequence. It is part of a group of four methods that are to be used together. The four methods are listed below:

• BeginEditSequence(DicomElement,Boolean,Int64)
• EndEditSequence
• BeginEditItem(Int32)
• EndEditItem

These methods are part of a fluent interface that are used to easily work with DICOM sequences. The methods can be chained together to create easily human readable code to create a sequence.

The DICOM sequence is created at the root of the DICOM data set by passing null for the parameter element, and true for the parameter tree. To create a sequence that is part of another sequence item, pass the sequence item element for the paramter element, and false for the parameter tree. For more information on the element and tree paramters, see FindFirstElement.

The format of the code for creating a sequence is as follows:

             ds.BeginEditSequence
               .BeginEditItem()
                  .InsertElementAndSetValue
                  .InsertElementAndSetValue
               .EndEditItem()
               .BeginEditItem()
                  .InsertElementAndSetValue
                  .InsertElementAndSetValue
               .EndEditItem()
             .EndEditSequence();
             

For an example, refer to GetValue.

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

Reference

DicomDataSet Class
DicomDataSet Members
Overload List
BeginEditSequence(DicomElement,Boolean,Int64) Method
EndEditSequence Method
BeginEditItem(Int32) Method
EndEditItem Method
BeginReadSequence(DicomElement,Boolean,Int64) Method
EndReadSequence Method
BeginReadItem(Int32) Method
EndReadItem Method