Signature Classe

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Représente une signature numérique ajoutée à un formulaire ou à un ensemble de données signées d'un formulaire.

public ref class Signature abstract

public abstract class Signature

type Signature = class

Public MustInherit Class Signature

Héritage

Object

Signature

Exemples

L'exemple ci-dessous affiche les informations sur la première signature du premier ensemble de données signées d'un formulaire (ou, si le modèle de formulaire est configuré pour signer tout le formulaire, les informations sur la première signature pour le formulaire entier). Tout d'abord, une référence à l'objet Signature représentant la signature est récupérée. Les propriétés Status et Comment de la classe Signature servent à obtenir l'état et les valeurs de commentaire de la signature. La propriété Certificate de la classe Signature est utilisée pour obtenir l'objet Certificate de la signature, qui sert ultérieurement à afficher le destinataire du certificat. La propriété SignatureBlockXmlNode de la classe Signature est utilisée pour récupérer la sous-arborescence du nœud XML qui contient les informations sur la signature. Enfin, toutes ces informations s'affichent dans une série de boîtes de message.

// 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)

Remarques

Utilisez la Item[Int32] propriété de la SignatureCollection collection pour renvoyer un objet Signature .

La classe Signature fournit la Sign() méthode permettant d’écrire le bloc de signature numérique XML et de calculer le hachage de chiffrement pour les données signées.

La classe Signature fournit les propriétés suivantes pour récupérer les informations sur la signature numérique :

• Certificate Obtient l’objet Certificate pour le certificat numérique X.509 avec lequel l’utilisateur du formulaire a signé un formulaire ou un jeu de données dans un formulaire.
• Comment Obtient le commentaire que l’utilisateur a ajouté à la signature numérique que l’utilisateur a associée à un formulaire ou à un jeu de données dans un formulaire.
• SignatureBlockXmlNode Obtient le nœud XML qui contient une signature numérique. Vous pouvez utiliser cette propriété pour étendre les propriétés de signature ou l'ensemble de données stockées dans la signature numérique par InfoPath.
• StatusObtient le status de la signature numérique spécifiée en tant que valeur d’énumérationSignatureStatus.

Constructeurs

Signature()

Représente une signature numérique ajoutée à un formulaire ou à un ensemble de données signées d'un formulaire.

Propriétés

Certificate	Obtient l’objet Certificate qui représente le certificat numérique X.509 utilisé pour signer un formulaire ou un ensemble de données signées dans un formulaire.
Comment	Obtient le texte de commentaire ajouté par l'utilisateur à la signature numérique associée à un formulaire ou à un ensemble de données signées d'un formulaire.
SignatureBlockXmlNode	Obtient un objet System.Xml.XPathNavigator positionné sur le nœud XML contenant une signature numérique.
Status	Obtient une SignatureStatus valeur qui spécifie le status de la signature numérique associée.

Méthodes

Sign()

Écrit le bloc de signature numérique XML et calcule le hachage cryptographique des données signées.