Clase SignatureCollection
Contiene un objeto Signature para cada firma digital aplicada a un formulario o a un conjunto de datos que se pueden firmar representados por un objeto SignedDataBlock.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.SignatureCollection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class SignatureCollection _
Implements IEnumerable
'Uso
Dim instance As SignatureCollection
public abstract class SignatureCollection : IEnumerable
Comentarios
Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.
Se puede tener acceso al objeto SignatureCollection para un formulario o un conjunto de datos que se pueden firmar mediante la propiedad Signatures del objeto SignedDataBlock que representa dicho conjunto de datos.
Si la plantilla de formulario está configurada para habilitar las firmas digitales de todo el formulario, sólo hay un objeto SignedDataBlock para todos los datos del formulario; dicho objeto SignatureCollection contiene todas las firmas digitales aplicadas a todo el formulario.
Si la plantilla de formulario está configurada para habilitar las firmas digitales para datos concretos del formulario, hay un objeto SignedDataBlock para cada conjunto de datos que se pueden firmar configurado en la plantilla de formulario. En ese caso, cada objeto SignedDataBlock contiene las firmas aplicadas al conjunto de datos que se pueden firmar asociados al objeto SignedDataBlock.
La clase SignatureCollection proporciona el método CreateSignature, que crea un objeto Signature (con una instantánea de la vista más otra información sobre firmas) sin agregarlo al formulario. Para agregar esta firma al formulario, debe llamar al método Sign de la clase Signature. Sólo puede llamar al método CreateSignature desde el controlador de eventos para el evento Sign, que sólo puede ser ejecutado por una plantilla de formulario de confianza plena.
La clase SignatureCollection proporciona también las propiedades Item y Count para tener acceso a los objetos de la colección Signature y contarlos.
Ejemplos
En el siguiente ejemplo, se devuelve el objeto SignatureCollection, que representa las firmas del primer conjunto de datos que se pueden firmar o, si está habilitada la firma para todo el formulario, devuelve el objeto SignatureCollection para las firmas de todo el formulario.
SignatureCollection block1Signatures =
this.SignedDataBlocks[0].Signatures;
Dim block1Signatures As SignatureCollection =
Me.SignedDataBlocks(0).Signatures
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.