Leadtools.Dicom Requires Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
BeginEditSequence(DicomElement,Boolean,Int64) Method
See Also 
Leadtools.Dicom Namespace > DicomDataSet Class > BeginEditSequence Method : BeginEditSequence(DicomElement,Boolean,Int64) Method



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
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
Used to create a new DICOM sequence, or edit an existing DICOM sequence

Syntax

Visual Basic (Declaration) 
Overloads Public Function BeginEditSequence( _
   ByVal element As DicomElement, _
   ByVal tree As Boolean, _
   ByVal tag As Long _
) As DicomDataSet
Visual Basic (Usage)Copy Code
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)
C# 
public DicomDataSet BeginEditSequence( 
   DicomElement element,
   bool tree,
   long tag
)
C++/CLI 
public:
DicomDataSet^ BeginEditSequence( 
   DicomElement^ element,
   bool tree,
   long 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

a reference to the DicomDataSet

Example

For an example, refer to GetValue.

Remarks

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:

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();

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features