Fasader API

Facader API

Facades API tillhandahåller förenklade, uppgiftsorienterade omslag runt kärnan
Aspose.PDF FOSS för .NET objektmodell.
Varje fasadklass riktar sig mot en specifik
PDF‑operation — formulärifyllning, filkonkatenering, innehållsredigering eller digital signering — och exponerar ett BindPdf / Save arbetsflöde.


Formulärifyllning med Form-fasad

Form (i Aspose.Pdf.Facades) binder till en befintlig PDF och låter dig läsa eller skriva AcroForm-fältvärden utan att navigera i sidträdet.

using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();

För att läsa fältvärden:

using var form = new Form("input.pdf");
string name = form.GetField("FirstName");

Sammanfoga och dela PDF-filer med PdfFileEditor

PdfFileEditor sammanfogar, delar, extraherar och tar bort sidintervall.

var editor = new PdfFileEditor();

// Concatenate two files
editor.Concatenate("file1.pdf", "file2.pdf", "merged.pdf");

// Extract pages 2-5
editor.Extract("source.pdf", 2, 5, "pages2to5.pdf");

// Split at page 3
editor.SplitFromFirst("source.pdf", 3, "first3.pdf");

Redigera sidinnehåll med PdfContentEditor

PdfContentEditor ändrar befintligt sidinnehåll — lägg till text, ersätt text eller bifoga åtgärder till annotationer.

var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");

Digitala signaturer med PdfFileSignature

PdfFileSignature signerar PDF-dokument och verifierar befintliga signaturer.

var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");

Sidstämpling med PdfFileStamp

PdfFileStamp lägger över text, bilder eller andra PDF‑sidor som stämplar.

var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();

Konvertera sidor till bilder med PdfConverter

PdfConverter renderar PDF‑sidor till rasterbildformat.

var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save images

Tips och bästa praxis

  • Anropa alltid Close() eller använd using för att frigöra resurser som hålls av fasadobjekt.
  • Använd BindPdf med en filsökväg för stora filer för att undvika att ladda in allt i minnet på en gång.
  • Föredra TryConcatenate och TryAppend framför deras icke‑Try‑motsvarigheter för smidig felhantering.
  • Fasader delegaterar internt till kärnmodellen Document — byt till kärn‑API:et när du behöver finmaskig kontroll.
  • FormEditor‑fasaden möjliggör att lägga till nya formulärfält i en befintlig PDF, inte bara att fylla i befintliga.

Vanliga problem

ProblemOrsakÅtgärd
Save() skapar tom filBindPdf anropades inte före sparningBind alltid en käll‑PDF innan du anropar Save
Formulärfältvärde skrivs inteFältnamnet matchar inte PDF:ens interna fältnamnAnvänd Form.FieldNames för att lista tillgängliga fältnamn
Konkatenation misslyckas tystInmatningsfilen är krypterad eller korruptAnvänd TryConcatenate och kontrollera returvärdet
Signaturer ogiltiga efter redigeringInnehållet ändrades efter signeringSignera dokumentet som sista steg

Vanliga frågor

Vad är skillnaden mellan Facades och kärnan Document API?

Facade‑klasser tillhandahåller hög‑nivå, uppgiftsorienterade metoder (fylla i ett formulär, slå ihop filer). Kärn‑API (Document, Page, Annotation) ger lägre‑nivå åtkomst till varje PDF‑objekt. Facade‑klasser använder kärn‑API:et internt.

Kan jag kedja flera fasadoperationer?

Ja. Bind samma källa, utför operationer och spara en gång. Eller spara ett mellanstegresultat och bind om för nästa operation.

Stöder PdfFileEditor lösenordsskyddade PDF-filer?

Ja. Överlagringar som accepterar ägare/användarlösenord är tillgängliga för krypterade filer.


API-referenssammanfattning

Class / MethodDescription
FormAcroForm-fasad för att läsa och skriva fältvärden
Form.FillFieldStäll in ett formulärfältvärde efter namn
Form.GetFieldLäs ett formulärfältvärde efter namn
FormEditorLägg till eller ändra formulärfält i en befintlig PDF
PdfFileEditorSammanfoga, dela, extrahera och ta bort PDF-sidintervall
PdfFileEditor.ConcatenateSammanfoga två eller fler PDF-filer till en
PdfFileEditor.ExtractExtrahera ett sidintervall till en ny PDF
PdfContentEditorÄndra sidinnehåll (text, kommentarer, åtgärder)
PdfFileSignatureSignera och verifiera PDF-digitala signaturer
PdfFileStampÖverlagra text- eller bildstämplar på sidor
PdfConverterRendera PDF-sidor till rasterbilder
FormattedTextStiliserad textbeskrivning för stämpeloperationer
FontStyleEnumeration av teckensnittsstilar (fet, kursiv osv.)
EncodingTypeEnumeration av teckenkodning

Se även

 Svenska