New to Telerik Document ProcessingStart a free 30-day trial

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:

C#
public class Signature

Inheritance: objectSignature

Constructors

Create a signature instance configured for external signing.

C#
public Signature(IExternalSigner signDataHandler)
Parameters:signDataHandlerIExternalSigner

The external signing handler that performs the actual signing operation.

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

C#
public Signature(X509Certificate2 certificate)
Parameters:certificateX509Certificate2

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

Methods

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

C#
public bool TryValidate(out SignatureValidationResult validationResult)
Parameters:validationResultSignatureValidationResult

When this method returns, contains the signature validation result.

Returns:

bool

Return true on success; otherwise false.

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

C#
public bool TryValidate(SignatureValidationProperties validationProperties, out SignatureValidationResult validationResult)
Parameters:validationPropertiesSignatureValidationProperties

The validation properties.

validationResultSignatureValidationResult

When this method returns, contains the signature validation result.

Returns:

bool

Return true on success; otherwise false.

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

C#
public SignatureValidationResult Validate()
Returns:

SignatureValidationResult

An instance of the SignatureValidationResult class.

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

C#
public SignatureValidationResult Validate(SignatureValidationProperties validationProperties)
Parameters:validationPropertiesSignatureValidationProperties

The validation properties.

Returns:

SignatureValidationResult

The validation result indicating whether the signature is valid.

Properties

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

C#
public SignatureDataProperties Properties { get; set; }
Property Value:

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

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

C#
public SignatureSettings Settings { get; }
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.

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

C#
public bool SupportsValidation { get; }
Property Value:

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