SignatureCollection Klasse

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Enthält ein Signature -Objekt für jede digitale Signatur, die auf ein Formular oder einen Satz von signierbaren Daten angewendet wird, die durch ein SignedDataBlock -Objekt dargestellt werden.

public ref class SignatureCollection abstract : System::Collections::IEnumerable

public abstract class SignatureCollection : System.Collections.IEnumerable

type SignatureCollection = class
    interface IEnumerable

Public MustInherit Class SignatureCollection
Implements IEnumerable

Vererbung

Object

SignatureCollection

Implementiert

IEnumerable

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

Hinweise

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Auf das SignatureCollection-Objekt für ein Formular oder einen Satz signierbarer Daten wird über die Signatures -Eigenschaft des SignedDataBlock-Objekts zugegriffen, die diesen Satz signierbarer Daten 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, die ein Signature -Objekt erstellt (Momentaufnahme der Ansicht sowie zusätzliche Signaturinformationen abrufen), ohne es dem Formular hinzuzufügen. Um diese Signatur dem Formular hinzuzufügen, rufen Sie die Sign() -Methode der Signature-Klasse auf. Sie können die CreateSignature-Methode nur aus dem Ereignishandler für das Sign Ereignis aufrufen, das nur von einer voll vertrauenswürdigen Formularvorlage ausgeführt werden kann.

Die SignatureCollection-Klasse stellt auch die Item[Int32] Eigenschaften und Count bereit, um auf die Signature-Objekte in der Auflistung zuzugreifen und diese zu zählen.

Konstruktoren

SignatureCollection()

Enthält ein Signature -Objekt für jede digitale Signatur, die auf ein Formular oder einen Satz von signierbaren Daten angewendet wird, die durch ein SignedDataBlock -Objekt dargestellt werden.

Eigenschaften

Count	Ruft die Anzahl der Signature -Objekte in der Auflistung ab.
Item[Int32]	Ruft einen Verweis auf das angegebene Signature -Objekt aus dem SignatureCollection -Objekt ab.

Methoden

CreateSignature()	Erstellt ein neues Signature -Objekt, ohne es dem Formular hinzuzufügen.
GetEnumerator()	Ruft ein System.Collections.IEnumerator-Objekt ab, das alle Einträge im SignatureCollection -Objekt durchläuft.