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 imagesTips och bästa praxis
- Anropa alltid
Close()eller användusingför att frigöra resurser som hålls av fasadobjekt. - Använd
BindPdfmed en filsökväg för stora filer för att undvika att ladda in allt i minnet på en gång. - Föredra
TryConcatenateochTryAppendframfö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
| Problem | Orsak | Åtgärd |
|---|---|---|
Save() skapar tom fil | BindPdf anropades inte före sparning | Bind alltid en käll‑PDF innan du anropar Save |
| Formulärfältvärde skrivs inte | Fältnamnet matchar inte PDF:ens interna fältnamn | Använd Form.FieldNames för att lista tillgängliga fältnamn |
| Konkatenation misslyckas tyst | Inmatningsfilen är krypterad eller korrupt | Använd TryConcatenate och kontrollera returvärdet |
| Signaturer ogiltiga efter redigering | Innehållet ändrades efter signering | Signera 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 / Method | Description |
|---|---|
Form | AcroForm-fasad för att läsa och skriva fältvärden |
Form.FillField | Ställ in ett formulärfältvärde efter namn |
Form.GetField | Läs ett formulärfältvärde efter namn |
FormEditor | Lägg till eller ändra formulärfält i en befintlig PDF |
PdfFileEditor | Sammanfoga, dela, extrahera och ta bort PDF-sidintervall |
PdfFileEditor.Concatenate | Sammanfoga två eller fler PDF-filer till en |
PdfFileEditor.Extract | Extrahera ett sidintervall till en ny PDF |
PdfContentEditor | Ändra sidinnehåll (text, kommentarer, åtgärder) |
PdfFileSignature | Signera och verifiera PDF-digitala signaturer |
PdfFileStamp | Överlagra text- eller bildstämplar på sidor |
PdfConverter | Rendera PDF-sidor till rasterbilder |
FormattedText | Stiliserad textbeskrivning för stämpeloperationer |
FontStyle | Enumeration av teckensnittsstilar (fet, kursiv osv.) |
EncodingType | Enumeration av teckenkodning |