SignatureCollection.CreateSignature-Methode
Erstellt ein neues Signature-Objekt, ohne es dem Formular hinzuzufügen.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Function CreateSignature As Signature
'Usage
Dim instance As SignatureCollection
Dim returnValue As Signature
returnValue = instance.CreateSignature()
public abstract Signature CreateSignature()
Rückgabewert
Typ: Microsoft.Office.InfoPath.Signature
Ein neues Signature-Objekt, das eine Momentaufnahme der Ansicht und zusätzliche Signaturinformationen enthält.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| SecurityException | Die Formularvorlage ist nicht für die Sicherheitsebene Voll vertrauenswürdig konfiguriert (Kategorie Sicherheit und Vertrauensstellung im Dialogfeld Formularoptionen). |
Hinweise
Durch die CreateSignature-Methode wird eine neue Signatur erstellt (Abrufen einer Momentaufnahme der Ansicht und zusätzlicher Signaturinformationen), ohne dem Formular die Signatur hinzuzufügen. Sie müssen die Sign-Methode der Signature-Klasse aufrufen, um diese Signatur dem Formular hinzuzufügen.
Die Methode kann nur aus einem Ereignishandler für das Sign-Ereignis aufgerufen werden.
Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie Sicherheit und Vertrauensstellung des Dialogfelds Formularoptionen konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code" auf MSDN.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die Codevorlage angezeigt, das der Formularvorlage hinzugefügt wird, wenn Sie einen Ereignishandler für das Sign-Ereignis hinzufügen. Dabei wird mithilfe der CreateSignature-Methode ein neues Signature-Objekt erstellt. Wenn die Sign-Methode der Signature-Klasse aufgerufen wird, wird das neue Signature-Objekt dem SignatureCollection-Objekt des Formulars hinzugefügt.
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