SignatureCollection-Klasse

Artikel
04/27/2010

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.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
<DefaultMemberAttribute("Item")> _
Public MustInherit Class SignatureCollection
    Implements IEnumerable
'Usage
Dim instance As SignatureCollection

[DefaultMemberAttribute("Item")] 
public abstract class SignatureCollection : IEnumerable

Hinweise

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 eines Snapshots 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.

Beispiel

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

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.SignatureCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

SignatureCollection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über