PdfFileSignature
Overview
PdfFileSignature is a class in Aspose.PDF FOSS for .NET.
Inherits from: IDisposable.
Facade for signing and reading digital signatures in PDF documents.
This class provides 71 methods for working with PdfFileSignature objects in .NET programs.
Available methods include: BindPdf, Certify, Close, ContainsSignature, ContainsUsageRights, CoversWholeDocument, Dispose, ExtractCertificate, ExtractImage, GetAccessPermissions, GetBlankSignNames, GetBlankSignatureNames, and 23 additional methods.
All public members are accessible to any .NET application after installing the Aspose.PDF FOSS for .NET package.
Properties: Document, IsCertified, IsLtvEnabled, SignatureAppearance, SignatureAppearanceStream.
Properties
| Name | Type | Access | Description |
|---|---|---|---|
Document | Document | Read | The bound document, lazily opened from the bound PDF bytes, for reading its fields / signatures. |
IsCertified | bool | Read | True when the bound document is certified — i.e. |
SignatureAppearance | string | Read/Write | Path to an image used as the visible signature appearance graphic. |
SignatureAppearanceStream | Stream? | Read/Write | Stream of bytes for the visible signature appearance graphic. |
IsLtvEnabled | bool | Read | True iff the document carries a /DSS (Document Security Store) entry in the catalog — the marker for LTV (long-term validation) enabled signatures. |
Methods
| Signature | Description |
|---|---|
Dispose() | Calls Dispose on this PdfFileSignature instance. |
Close() | Calls Close on this PdfFileSignature instance. |
PdfFileSignature() | Calls PdfFileSignature on this PdfFileSignature instance. |
PdfFileSignature(document: Document) | Calls PdfFileSignature(document) on this PdfFileSignature instance. |
PdfFileSignature(document: Document, outputFile: string) | Calls PdfFileSignature(document, outputFile) on this PdfFileSignature instance. |
PdfFileSignature(inputFile: string) | Calls PdfFileSignature(inputFile) on this PdfFileSignature instance. |
PdfFileSignature(inputFile: string, outputFile: string) | Calls PdfFileSignature(inputFile, outputFile) on this PdfFileSignature instance. |
BindPdf(inputFile: string) | Calls BindPdf(inputFile) on this PdfFileSignature instance. |
BindPdf(input: byte[]) | Calls BindPdf(input) on this PdfFileSignature instance. |
BindPdf(inputStream: Stream) | Calls BindPdf(inputStream) on this PdfFileSignature instance. |
BindPdf(document: Document) | Calls BindPdf(document) on this PdfFileSignature instance. |
GetSignNames() | Calls GetSignNames on this PdfFileSignature instance. |
GetSignNames(onlyActive: bool) | Active signatures only when onlyActive is true; otherwise returns every signature field that carries a /V value (matches the parameterless overload). |
GetSignatureNames() | All signed signature fields wrapped as SignatureName entries (matches the partial+full+HasSignature shape Aspose.Pdf expects). |
GetSignatureNames(onlyActive: bool) | Filter on signature activity — same predicate as GetSignNames(bool). |
GetBlankSignNames() | Names of signature fields that exist on the form but carry no signature value (/V entry absent). |
GetBlankSignatureNames() | Calls GetBlankSignatureNames on this PdfFileSignature instance. |
GetRevision(signName: string) | Revision index of the named signature (1-based) — counts signatures in the order they appear in the field tree. |
GetRevision(signName: SignatureName) | Calls GetRevision(signName) on this PdfFileSignature instance. |
GetTotalRevision() | Total number of signatures present in the document (1-based max revision returned by GetRevision(string)). |
GetAccessPermissions() | Read the certifying signature’s /DocMDP /P access-permission level (1, 2, or 3 per PDF 32000-1 §12.8.2.2). |
CoversWholeDocument(signName: string) | Whether the named signature covers the entire bound document (i.e. |
CoversWholeDocument(signName: SignatureName) | Calls CoversWholeDocument(signName) on this PdfFileSignature instance. |
RemoveSignature(signName: SignatureName) | Calls RemoveSignature(signName) on this PdfFileSignature instance. |
RemoveSignature(signName: SignatureName, removeField: bool) | Calls RemoveSignature(signName, removeField) on this PdfFileSignature instance. |
VerifySignature(signName: SignatureName) | Calls VerifySignature(signName) on this PdfFileSignature instance. |
GetSignerName(signName: SignatureName) | Calls GetSignerName(signName) on this PdfFileSignature instance. |
GetReason(signName: SignatureName) | Calls GetReason(signName) on this PdfFileSignature instance. |
GetLocation(signName: SignatureName) | Calls GetLocation(signName) on this PdfFileSignature instance. |
GetContactInfo(signName: SignatureName) | Calls GetContactInfo(signName) on this PdfFileSignature instance. |
GetDateTime(signName: SignatureName) | Calls GetDateTime(signName) on this PdfFileSignature instance. |
ExtractCertificate(signName: SignatureName) | Calls ExtractCertificate(signName) on this PdfFileSignature instance. |
TryExtractCertificate(signName: SignatureName, stream: Stream) | Calls TryExtractCertificate(signName, stream) on this PdfFileSignature instance. |
TryExtractCertificate(signName: SignatureName, certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | Calls TryExtractCertificate(signName, certificate) on this PdfFileSignature instance. |
VerifySignature(signName: string) | Calls VerifySignature(signName) on this PdfFileSignature instance. |
GetSignerName(signName: string) | Calls GetSignerName(signName) on this PdfFileSignature instance. |
GetReason(signName: string) | Calls GetReason(signName) on this PdfFileSignature instance. |
GetLocation(signName: string) | Calls GetLocation(signName) on this PdfFileSignature instance. |
GetContactInfo(signName: string) | Calls GetContactInfo(signName) on this PdfFileSignature instance. |
GetDateTime(signName: string) | Calls GetDateTime(signName) on this PdfFileSignature instance. |
IsCoversWholeDocument(signName: string) | Calls IsCoversWholeDocument(signName) on this PdfFileSignature instance. |
RemoveSignature(signName: string) | Calls RemoveSignature(signName) on this PdfFileSignature instance. |
RemoveSignature(signName: string, removeField: bool) | Remove the signature value (removeField false) or the entire signature field (true) by name. |
RemoveSignatures() | Calls RemoveSignatures on this PdfFileSignature instance. |
IsContainSignature() | Returns true if contain signature is set. |
ExtractCertificate(signName: string) | Extract the X.509 signing certificate from the named signature field and return it as a memory stream of DER-encoded bytes (.cer format). |
ContainsUsageRights() | Calls ContainsUsageRights on this PdfFileSignature instance. |
RemoveUsageRights() | Calls RemoveUsageRights on this PdfFileSignature instance. |
ContainsSignature() | Calls ContainsSignature on this PdfFileSignature instance. |
Save(outputFile: string) | Calls Save(outputFile) on this PdfFileSignature instance. |
Save(outputStream: Stream) | Calls Save(outputStream) on this PdfFileSignature instance. |
SetCertificate(pfx: string, pass: string) | Load a signing certificate from a PFX/PKCS#12 file. |
Sign(page: int, SigReason: string, SigContact: string, SigLocation: string, visible: bool, annotRect: System.Drawing.Rectangle) | Sign with the previously-loaded SetCertificate certificate. |
Sign(page: int, visible: bool, annotRect: System.Drawing.Rectangle, sig: Forms.Signature) | Sign on the given page using the certificate embedded in sig. |
Sign(page: int, SigReason: string, SigContact: string, SigLocation: string, visible: bool, annotRect: System.Drawing.Rectangle, sig: Forms.Signature) | Sign on the given page with explicit metadata, using the certificate embedded in sig. |
Sign(page: int, SigName: string, SigReason: string, SigContact: string, SigLocation: string, visible: bool, annotRect: System.Drawing.Rectangle, sig: Forms.Signature) | Sign with explicit field name + metadata. |
Sign(SigName: string, sig: Forms.Signature) | Sign an existing blank signature field by name. |
Sign(SigName: string, SigReason: string, SigContact: string, SigLocation: string, sig: Forms.Signature) | Sign an existing blank signature field by name with explicit metadata. |
Certify(page: int, SigReason: string, SigContact: string, SigLocation: string, visible: bool, annotRect: System.Drawing.Rectangle, docMdpSignature: Forms.DocMDPSignature) | Sign on the given page with a /DocMDP reference so the resulting signature is a certifying signature (PDF 32000-1 §12.8.2.2). |
Certify(sigName: string, docMdpSignature: Forms.DocMDPSignature) | Certify an existing blank signature field by name. |
VerifySigned(signName: string) | Verifies that a signed signature is intact. |
VerifySignature(signName: string, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Verify a signature with explicit options + return a ValidationResult describing the outcome. |
VerifySignature(signName: string, publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Calls VerifySignature(signName, publicKeyCertificate, options, validationResult) on this PdfFileSignature instance. |
VerifySignature(signName: Facades.SignatureName, publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | Cert-pinned verify without ValidationOptions. |
VerifySignature(signName: Facades.SignatureName, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Calls VerifySignature(signName, options, validationResult) on this PdfFileSignature instance. |
VerifySignature(signName: Facades.SignatureName, publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Calls VerifySignature(signName, publicKeyCertificate, options, validationResult) on this PdfFileSignature instance. |
GetSignaturesInfo() | Per-signature algorithm/digest/standard triple, parsed from each signature’s PKCS#7 /Contents. |
ExtractImage(signName: string) | Extract the /AP /N (normal appearance) stream of the named signature’s widget. |
ExtractImage(signName: SignatureName) | Calls ExtractImage(signName) on this PdfFileSignature instance. |
Save() | Save the bound (possibly signed) document to the outputFile argument from the ctor. |
ToByteArray() | FOSS-only convenience: return the bound (possibly signed) PDF bytes. |
