SignatureCollection.CreateSignature-Methode

Artikel
04/27/2010

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

Ein neues Signature-Objekt, das einen Snapshot der Ansicht und zusätzliche Signaturinformationen enthält.

Ausnahmen

Ausnahmetyp	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 eines Snapshots 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 "Using Libraries from Partially Trusted Code" (in Englisch) auf MSDN.

Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

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

Siehe auch

Referenz

SignatureCollection-Klasse
SignatureCollection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über