Leadtools.Dicom Namespace > DicomDataSet Class > Copy Method : Copy(DicomDataSet,DicomElement,DicomElement) Method |
public void Copy( DicomDataSet dataSet, DicomElement destination, DicomElement source )
'Declaration Public Overloads Sub Copy( _ ByVal dataSet As DicomDataSet, _ ByVal destination As DicomElement, _ ByVal source As DicomElement _ )
'Usage Dim instance As DicomDataSet Dim dataSet As DicomDataSet Dim destination As DicomElement Dim source As DicomElement instance.Copy(dataSet, destination, source)
public void Copy( DicomDataSet dataSet, DicomElement destination, DicomElement source )
ObjectiveC Syntax
function Leadtools.Dicom.DicomDataSet.Copy(DicomDataSet,DicomElement,DicomElement)( dataSet , destination , source )
public: void Copy( DicomDataSet^ dataSet, DicomElement^ destination, DicomElement^ source )
If source is not null and destination is null, the children of source will be added at the root level of the destination Data Set (i.e., as siblings to elements at the highest level). This can be seen in the diagram below. Note that the source elements to be added are in blue.
If source is null and destination is not null, the entire source Data Set will be added as children to destination. This can be seen in the diagram below.
If source and destination are both not null, then the children of source are added as the children of destination. This can be seen in the diagram below. The original children of destination are in red and the source elements to be added are in blue.
If an inserted element has the same tag value as a destination element at the same level and with the same parent, then the value from the source element is copied into the destination element and any child elements are added accordingly. For example, the diagram below shows the result of a call to Copy(DicomDataSet,DicomElement,DicomElement). If the two elements indicated by the arrows have the same tag value, the value from the source element is copied into the destination element and the structure on the right results. This is shown by the red outline of the destination element with the blue center of the source element.
To make the destination Data Set an exact copy of the source Data Set, instead of inserting it within the destination Data Set, you must call Reset on the destination Data Set, before calling Copy(DicomDataSet,DicomElement,DicomElement).
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