Public Function GetNextUnusedPrivateTag( _
   ByVal privateCreatorDataElement As DicomElement _
) As Integer

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim privateCreatorDataElement As DicomElement Dim value As Integer   value = instance.GetNextUnusedPrivateTag(privateCreatorDataElement)

public int GetNextUnusedPrivateTag( 
   DicomElement privateCreatorDataElement
)

public:
int GetNextUnusedPrivateTag( 
   DicomElement^ privateCreatorDataElement
) 

Parameters

privateCreatorDataElement

Private Creator Data Element

Return Value

This feature is available in version 16 or higher.

This method is used together with any of the following functions:

• CreatePrivateCreatorDataElement
• FindFirstPrivateCreatorDataElement
• FindNextPrivateCreatorDataElement

to create private elements in a DICOM data set. For more information on private elements, see CreatePrivateCreatorDataElement.

Use this method with an existing private creator data element to create private elements. If successful, the return value will be the next available unused tag that has been reserved by the Private Creator Data Element

For example, suppose the following tags exist in a DICOM data set:

• (0017, 0012) private creator data element
• (0017, 1200) private element
• (0017, 1201) private element
• (0017, 1205) private element

After a successful call to GetNextUnusedPrivateTag, the return value is 0x00171202, which can be used with InsertElement to add a new private element

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

Reference