Signature-Klasse
Stellt eine digitale Signatur dar, die einem Formular oder einer Gruppe signierter Daten in einem Formular hinzugefügt wurde.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)
Syntax
'Declaration
Public MustInherit Class Signature
'Usage
Dim instance As Signature
public abstract class Signature
Hinweise
Verwenden Sie die Item-Eigenschaft der SignatureCollection-Auflistung, um ein Signature-Objekt zurückzugeben.
Die Signature-Klasse bietet die Sign-Methode zum Schreiben des digitalen XML-Signaturblocks und zum Berechnen des kryptografischen Hash für die signierten Daten.
Die Signature-Klasse bietet die folgenden Eigenschaften zum Abrufen von Informationen zur digitalen Signatur:
Certificate Ruft das Certificate-Objekt für das digitale X.509-Zertifikat ab, mit dem der Benutzer des Formulars ein Formular oder eine Datengruppe in einem Formular signiert hat.
Comment Ruft den Kommentar ab, den der Benutzer der digitalen Signatur hinzugefügt hat, die der Benutzer mit einem Formular oder einer Datengruppe in einem Formular verknüpft hat.
SignatureBlockXmlNode Ruft den XML-Knoten ab, der eine digitale Signatur enthält. Sie können mithilfe dieser Eigenschaft die Signatureigenschaften oder die Datengruppe erweitern, die InfoPath mit der Signatur speichert.
Status Ruft den Status der angegebenen digitalen Signatur als SignatureStatus-Enumerationswert ab.
Beispiel
Im folgenden Beispiel werden Informationen zur ersten digitalen Signatur für die erste signierte Datengruppe in einem Formular angezeigt (bzw. wenn das Formular so konfiguriert ist, dass das gesamte Formular signiert wird, Informationen zur ersten Signatur für das gesamte Formular). Zuerst wird ein Verweis auf das Signature-Objekt abgerufen, das die Signatur darstellt. Die Eigenschaften Status und Comment der Signature-Klasse werden verwendet, um den Status und die Kommentarwerte von der Signatur abzurufen. Die Certificate-Eigenschaft der Signature-Klasse wird verwendet, um das Certificate-Objekt der Signatur abzurufen. Dies wird später verwendet, um anzuzeigen, an wen das Zertifikat ausgegeben wurde. Die SignatureBlockXmlNode-Eigenschaft der Signature-Klasse dient zum Abrufen der untergeordneten XML-Knotenstruktur, die die Signaturinformationen enthält. Zum Schluss werden sämtliche dieser Informationen in einer Reihe von Meldungsfeldern angezeigt.
// Get signature.
Signature mySignature = this.SignedDataBlocks[0].Signatures[0];
// Get status of signature.
string sigStatus = mySignature.Status.ToString();
// Get comment.
string signatureComment = mySignature.Comment;
// Get certificate used to sign with.
Certificate signatureCertificate = mySignature.Certificate;
// Get XML node that contains the signature.
XPathNavigator signatureNode = mySignature.SignatureBlockXmlNode;
// Display properties.
MessageBox.Show("Signature properties:\n\nStatus: " + sigStatus +
"\nComment: " + signatureComment +
"\nCertificate Issued To: " + signatureCertificate.IssuedTo);
// Display XML node subtree that contains signature.
MessageBox.Show("Digital signature XML block: \n" + signatureNode.InnerXml);
Imports Microsoft.VisualBasic.Constants
' Get signature.
Dim mySignature As Signature = Me.SignedDataBlocks(0).Signatures(0)
' Get status of signature.
Dim sigStatus As String = mySignature.Status.ToString()
' Get comment.
Dim signatureComment As String = mySignature.Comment
' Get certificate used to sign with.
Dim signatureCertificate As Certificate = mySignature.Certificate
' Get XML node that contains the signature.
Dim signatureNode As XPathNavigator = mySignature.SignatureBlockXmlNode
' Display properties.
MessageBox.Show("Signature properties:" & NewLine & _
"Status: " & sigStatus & NewLine & _
"Comment: " & signatureComment & NewLine & _
"Certificate Issued To: " & signatureCertificate.IssuedTo)
' Display XML node subtree that contains signature.
MessageBox.Show("Digital signature XML block:" & NewLine & _
signatureNode.InnerXml)
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.Signature
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.