SignatureCollection.CreateSignature, méthode
Crée un objet Signature sans l'ajouter au formulaire.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Function CreateSignature As Signature
'Utilisation
Dim instance As SignatureCollection
Dim returnValue As Signature
returnValue = instance.CreateSignature()
public abstract Signature CreateSignature()
Valeur de retour
Type : Microsoft.Office.InfoPath.Signature
Nouvel objet Signature contenant un instantané de la vue avec des informations de signature supplémentaires.
Exceptions
| Exception | Condition |
|---|---|
| SecurityException | Le modèle de formulaire n'est pas configuré avec l'option Autorisation totale de la catégorie Sécurité et approbation dans la boîte de dialogue Options de formulaire. |
Remarques
La méthode CreateSignature crée une signature (permettant d'obtenir un instantané de la vue avec des informations de signature supplémentaires) sans l'ajouter au formulaire. Pour ajouter cette signature au formulaire, appelez la méthode Sign de la classe Signature.
Cette méthode ne peut être appelée qu'à partir d'un gestionnaire d'événements pour l'événement Sign.
Ce membre est accessible uniquement par les formulaires ouverts à partir d’un modèle de formulaire configuré pour être exécuté avec des autorisations totales à l’aide de la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire. Ce membre nécessite une autorisation totale pour l’appelant immédiat et ne peut pas être utilisé par un code partiellement fiable. Pour plus d’informations, voir « Using Libraries from Partially Trusted Code » (« Utilisation de bibliothèques à partir de code partiellement fiable ») (éventuellement en anglais) sur MSDN.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
L'exemple ci-dessous illustre le squelette de code ajouté au modèle de formulaire lors de l'ajout d'un gestionnaire d'événements pour l'événement Sign. Il utilise la méthode CreateSignature pour créer un objet Signature. Lors de l'appel de la méthode Sign de la classe Signature, le nouvel objet Signature est ajouté à l'objet SignatureCollection du formulaire.
public void FormEvents_Sign(object sender, SignEventArgs e)
{
// This event handler will run only in fully trusted form templates.
Signature thisSignature =
e.SignedDataBlock.Signatures.CreateSignature();
// To add other pieces of information to sign, modify the
// signature template returned by
// thisSignature.SignatureBlockXmlNode.
// Write your code here.
thisSignature.Sign();
e.SignatureWizard = false;
}
Public Sub FormEvents_Sign(ByVal sender As Object, _
ByVal e As SignEventArgs)
' This event handler will run only in fully trusted form templates.
Dim thisSignature As Signature = _
e.SignedDataBlock.Signatures.CreateSignature()
' To add other pieces of information to sign, modify the
' signature template returned by
' thisSignature.SignatureBlockXmlNode.
' Write your code here.
thisSignature.Sign()
e.SignatureWizard = False
End Sub