SignatureCollection-Klasse
Enthält ein Signature-Objekt für jede digitale Signatur, die auf ein Formular oder eine signierbare Datengruppe angewendet wird, dargestellt durch ein SignedDataBlock-Objekt.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.SignatureCollection
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class SignatureCollection _
Implements IEnumerable
'Usage
Dim instance As SignatureCollection
public abstract class SignatureCollection : IEnumerable
Hinweise
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.
Auf das SignatureCollection-Objekt für ein Formular oder eine signierbare Datengruppe wird über die Signatures-Eigenschaft des SignedDataBlock-Objekts zugegriffen, das diese signierbare Datengruppe darstellt.
Wenn die Formularvorlage so konfiguriert ist, dass digitale Signaturen für das gesamte Formular aktiviert sind, ist nur ein SignedDataBlock-Objekt für alle Daten im Formular vorhanden. Das SignatureCollectionObjekt enthält in diesem Fall alle digitalen Signaturen, die auf das gesamte Formular angewendet werden.
Wenn die Formularvorlage so konfiguriert ist, dass digitale Signaturen für bestimmte Daten im Formular aktiviert sind, ist ein SignedDataBlock-Objekt für jede signierbare Datengruppe vorhanden, die in der Formularvorlage konfiguriert ist. In diesem Fall enthält jedes SignedDataBlock-Objekt die digitalen Signaturen, die auf die signierbare Datengruppe angewendet werden, die mit dem SignedDataBlock-Objekt verknüpft ist.
Die SignatureCollection-Klasse stellt die CreateSignature-Methode bereit. Mit dieser Methode wird ein Signature-Objekt erstellt (Abrufen einer Momentaufnahme der Ansicht sowie weiterer Signaturinformationen), ohne es dem Formular hinzuzufügen. Rufen Sie die Sign-Methode der Signature-Klasse auf, um dem Formular diese Signatur hinzuzufügen. Sie können nur die CreateSignature-Methode aus dem Ereignishandler für das Sign-Ereignis aufrufen, das nur von einer vollständig vertrauenswürdigen Formularvorlage ausgeführt werden kann.
Die SignatureCollection-Klasse liefert außerdem die Eigenschaften Item und Count, um auf die Signature-Objekte in der Auflistung zuzugreifen und sie zu zählen.
Beispiele
Im folgenden Beispiel wird das SignatureCollection-Objekt zurückgegeben, das die Signaturen für die erste signierbare Datengruppe darstellt. Bei aktivierter Signierung für das gesamte Formular wird das SignatureCollection-Objekt für Signaturen für das gesamte Formular zurückgegeben.
SignatureCollection block1Signatures =
this.SignedDataBlocks[0].Signatures;
Dim block1Signatures As SignatureCollection =
Me.SignedDataBlocks(0).Signatures
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.