Leadtools.Dicom Requires Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.10.31
FindSignature Method
See Also  Example
Leadtools.Dicom Namespace > DicomDataSet Class : FindSignature Method




signatureUID
Character string that contains the Digital Signature UID of the Digital Signature for which to search.
Returns the Digital Signatures Sequence Item that corresponds to the Digital Signature that has the specified Digital Signature UID, if found in the Data Set.

Syntax

Visual Basic (Declaration) 
Public Function FindSignature( _
   ByVal signatureUID As String _
) As DicomElement
Visual Basic (Usage)Copy Code
Dim instance As DicomDataSet
Dim signatureUID As String
Dim value As DicomElement
 
value = instance.FindSignature(signatureUID)
C# 
public DicomElement FindSignature( 
   string signatureUID
)
Managed Extensions for C++ 
public: DicomElement* FindSignature( 
   string* signatureUID
) 
C++/CLI 
public:
DicomElement^ FindSignature( 
   String^ signatureUID
) 

Parameters

signatureUID
Character string that contains the Digital Signature UID of the Digital Signature for which to search.

Return Value

The Digital Signatures Sequence Item that corresponds to the Digital Signature with the specified Digital Signature UID, or a null reference (Nothing in Visual Basic) if no such Digital Signature was found in the Data Set.

Example

This example will locate (find) a digital signature inside a DICOM dataset by searching for its UID.

Visual BasicCopy Code
Public Sub FindSignature()
  Dim dicomFileName As String = "C:\Program Files\LEAD Technologies, Inc\LEADTOOLS 14.5\Images\IMAGE3.dic"
  'Make sure to initialize the DICOM engine, this needs to be done only once
  'In the whole application
  DicomEngine.Startup()

    Dim ds As DicomDataSet = New DicomDataSet()
    Using (ds)

       'Load DICOM File
       ds.Load(dicomFileName, DicomDataSetLoadFlags.None)
       Dim signatureUID As String = "1.2.840.114257.0.130573664"
       ' Search the whole Data Set for the Digital Signature with the
       ' specified Digital Signature UID
       Dim signatureItem As DicomElement = ds.FindSignature(signatureUID)
       If Not signatureItem Is Nothing Then
          ds.DeleteSignature(signatureItem)
          MessageBox.Show("The Digital Signature was found and got deleted.", "Sample")
       Else
          MessageBox.Show("The Digital Signature could not be found.", "Sample")
       End If
    End Using

    DicomEngine.Shutdown()
 End Sub
C#Copy Code
public void FindSignature()  

   string dicomFileName  = @"C:\Program Files\LEAD Technologies, Inc\LEADTOOLS 14.5\Images\IMAGE3.dic"; 
   //Make sure to initialize the DICOM engine, this needs to be done only once  
   //In the whole application 
   DicomEngine.Startup(); 
   using(DicomDataSet ds = new DicomDataSet()) 
   { 
      //Load DICOM File 
      ds.Load(dicomFileName, DicomDataSetLoadFlags.None); 
      string signatureUID = "1.2.840.114257.0.130573664"; 
      // Search the whole Data Set for the Digital Signature with the 
      // specified Digital Signature UID 
      DicomElement signatureItem = ds.FindSignature(signatureUID); 
      if (signatureItem != null) 
      { 
         ds.DeleteSignature(signatureItem); 
         MessageBox.Show("The Digital Signature was found and got deleted.", "Sample"); 
      } 
      else 
      { 
         MessageBox.Show("The Digital Signature could not be found.", "Sample"); 
      } 
   } 
   DicomEngine.Shutdown(); 
}

Remarks

Each Digital Signature should be uniquely identified by a UID specified by the Digital Signature UID (0400,0100) under the corresponding Digital Signatures Sequence Item. Call this method to search the whole Data Set for a Digital Signature by its Digital Signature UID.

Once the Digital Signatures Sequence Item is obtained, the following methods can be used to verify, delete, or get information about the Digital Signature:

VerifySignature

DeleteSignature

GetSignatureUID

GetSignatureDateTime

GetSignedElementsCount

GetSignedElement

GetMacTransferSyntax

GetMacAlgorithm

SaveCertificate

Call the GetSignaturesCount and GetSignature methods to enumerate the Digital Signatures in the main Data Set or in an item of a Sequence of Items.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

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