Class
Signature

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

Definition

Namespace:Telerik.Windows.Documents.Fixed.Model.DigitalSignatures

Assembly:Telerik.Windows.Documents.Fixed.dll

Syntax:

cs-api-definition
public class Signature

Inheritance: objectSignature

Constructors

Signature(IExternalSigner)

Create a signature instance configured for external signing.

Declaration

cs-api-definition
public Signature(IExternalSigner signDataHandler)

Parameters

signDataHandler

IExternalSigner

The external signing handler that performs the actual signing operation.

Signature(X509Certificate2)

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

Declaration

cs-api-definition
public Signature(X509Certificate2 certificate)

Parameters

certificate

X509Certificate2

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

Properties

Properties

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

Declaration

cs-api-definition
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

cs-api-definition
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

cs-api-definition
public bool SupportsValidation { get; }

Property Value

bool

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

cs-api-definition
public bool TryValidate(SignatureValidationProperties validationProperties, out SignatureValidationResult validationResult)

Parameters

validationProperties

SignatureValidationProperties

The validation properties.

validationResult

SignatureValidationResult

When this method returns, contains the signature validation result.

Returns

bool

Return true on success; otherwise false.

TryValidate(out SignatureValidationResult)

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

Declaration

cs-api-definition
public bool TryValidate(out SignatureValidationResult validationResult)

Parameters

validationResult

SignatureValidationResult

When this method returns, contains the signature validation result.

Returns

bool

Return true on success; otherwise false.

Validate()

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

Declaration

cs-api-definition
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

cs-api-definition
public SignatureValidationResult Validate(SignatureValidationProperties validationProperties)

Parameters

validationProperties

SignatureValidationProperties

The validation properties.

Returns

SignatureValidationResult

The validation result indicating whether the signature is valid.