Class Signature

Digital signature API for signing and validating PDF content, enabling integrity checks and signer attribution.

Inheritance
System.Object
Signature
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.Windows.Documents.Fixed.Model.DigitalSignatures
Assembly: Telerik.Windows.Documents.Fixed.dll

Syntax

public class Signature

Constructors

Signature(X509Certificate2)

Create a signature instance bound to an X.509 certificate used for signing.

Declaration
public Signature(X509Certificate2 certificate)
Parameters
System.Security.Cryptography.X509Certificates.X509Certificate2 certificate

The X.509 certificate containing the private key used for digital signing.

Signature(IExternalSigner)

Create a signature instance configured for external signing.

Declaration
public Signature(IExternalSigner signDataHandler)
Parameters
IExternalSigner signDataHandler

The external signing handler that performs the actual signing operation.

Properties

Properties

Metadata and configuration for the signature (signer info, time, location, contents, and byte ranges).

Declaration
public SignatureDataProperties Properties { get; set; }
Property Value
SignatureDataProperties

The signature data properties that define the signature's characteristics and metadata.

Settings

Signing configuration applied when producing (or guiding external production of) the CMS / PKCS#7 signature.

Declaration
public SignatureSettings Settings { get; }
Property Value
SignatureSettings

Remarks

Values contained here (e.g. selected digest algorithm) are not written directly as PDF dictionary keys; they influence how the CMS envelope is built for new signatures. Changing settings after the signature bytes (/Contents) have been generated has no effect on that existing signature.

SupportsValidation

Indicates whether this instance supports validation (imported signatures only).

Declaration
public bool SupportsValidation { get; }
Property Value
System.Boolean

true if the signature was imported from an existing document and can be validated; false for newly created signatures.

Methods

TryValidate(SignatureValidationProperties, out SignatureValidationResult)

Validate the signature using the provided properties and return whether validation succeeded.

Declaration
public bool TryValidate(SignatureValidationProperties validationProperties, out SignatureValidationResult validationResult)
Parameters
SignatureValidationProperties validationProperties

The validation properties.
SignatureValidationResult validationResult

When this method returns, contains the signature validation result.
Returns
System.Boolean

Return true on success; otherwise false.

TryValidate(out SignatureValidationResult)

Validate the signature using default settings and return whether validation succeeded.

Declaration
public bool TryValidate(out SignatureValidationResult validationResult)
Parameters
SignatureValidationResult validationResult

When this method returns, contains the signature validation result.
Returns
System.Boolean

Return true on success; otherwise false.

Validate()

Validate the signature using default validation properties and return the result.

Declaration
public SignatureValidationResult Validate()
Returns
SignatureValidationResult

An instance of the SignatureValidationResult class.

Validate(SignatureValidationProperties)

Validate the signature using the specified properties and return the validation result.

Declaration
public SignatureValidationResult Validate(SignatureValidationProperties validationProperties)
Parameters
SignatureValidationProperties validationProperties

The validation properties.
Returns
SignatureValidationResult

The validation result indicating whether the signature is valid.