Fasádok API

Fasádok API

A Facades API egyszerűsített, feladatorientált burkolókat biztosít a core Aspose.PDF FOSS for .NET objektummodell körül. Minden facade osztály egy adott PDF műveletre céloz — űrlapkitöltés, fájlösszefűzés, tartalomszerkesztés vagy digitális aláírás — és egy BindPdf / Save munkafolyamatot tesz elérhetővé.


Űrlap kitöltése a Form facade használatával

Form (a Aspose.Pdf.Facades‑ban) egy meglévő PDF-hez kötődik, és lehetővé teszi az AcroForm mezőértékek olvasását vagy írását anélkül, hogy az oldalfát be kellene járni.

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

A mezőértékek beolvasásához:

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

PDF-ek egyesítése és felosztása a PdfFileEditor-rel

PdfFileEditor összefűzi, felosztja, kinyeri és törli az oldaltartományokat.

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");

Oldaltartalom szerkesztése a PdfContentEditor segítségével

PdfContentEditor módosítja a meglévő oldal tartalmát — szöveget ad hozzá, szöveget cserél, vagy műveleteket csatol a megjegyzésekhez.

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

Digitális aláírások a PdfFileSignature segítségével

PdfFileSignature aláír PDF dokumentumokat, és ellenőrzi a meglévő aláírásokat.

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

Oldalbélyegzés a PdfFileStamp használatával

PdfFileStamp szöveget, képeket vagy más PDF oldalakat helyez el bélyegzőként.

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

Oldalak képekké konvertálása a PdfConverter segítségével

PdfConverter PDF oldalakat raszteres képformátumokra rendereli.

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

Tippek és legjobb gyakorlatok

  • Mindig hívd meg a Close()-t, vagy használd a using-t a felület objektumok által foglalt erőforrások felszabadításához.
  • Használd a BindPdf-t fájlúttal nagy fájlok esetén, hogy elkerüld az összes adat egyszerre a memóriába töltését.
  • Részesítsd előnyben a TryConcatenate-t és a TryAppend-t a nem Try változataik helyett a kifogásolható hibakezelés érdekében.
  • A felületek belsőleg a mag Document modellnek delegálnak — válts a mag API-ra, ha finomhangolt vezérlésre van szükséged.
  • A FormEditor felület lehetővé teszi új űrlapmezők hozzáadását egy meglévő PDF-hez, nem csak a meglévő mezők kitöltését.

Gyakori problémák

IssueCauseFix
Save() üres fájlt hoz létreBindPdf nem lett meghívva a mentés előttMindig kössön egy forrás PDF-et, mielőtt meghívná a Save‑t
Az űrlapmező értéke nem íródikA mező neve nem egyezik a PDF belső mezőnevévelHasználja a Form.FieldNames‑t az elérhető mezőnevek listázásához
Az összefűzés csendben sikertelenA bemeneti fájl titkosított vagy sérültHasználja a TryConcatenate‑t, és ellenőrizze a visszatérési értéket
Az aláírások érvénytelenek a szerkesztés utánA tartalom módosult az aláírás utánAláírja a dokumentumot az utolsó lépésként

GYIK

Mi a különbség a Facades és a core Document API között?

Fasádok magas szintű, feladatra orientált módszereket biztosítanak (űrlap kitöltése, fájlok egyesítése). A mag API (Document, Page, Annotation) alacsonyabb szintű hozzáférést biztosít minden PDF objektumhoz. Fasádok belsőleg a mag API-t használják.

Láncolhatok több facade műveletet?

Igen. Kösse ugyanazt a forrást, hajtsa végre a műveleteket, és mentse egyszer. Vagy mentse a köztes eredményt
és kössön újra a következő művelethez.

Támogatja a PdfFileEditor a jelszóval védett PDF-eket?

Igen. A tulajdonos/felhasználó jelszavakat elfogadó túlterhelések elérhetők titkosított fájlokhoz.


API Referencia Összefoglaló

Class / MethodDescription
FormAcroForm felület a mezőértékek olvasásához és írásához
Form.FillFieldŰrlapmező értékének beállítása név alapján
Form.GetFieldŰrlapmező értékének olvasása név alapján
FormEditorŰrlapmezők hozzáadása vagy módosítása egy meglévő PDF-ben
PdfFileEditorPDF oldaltartományok egyesítése, felosztása, kinyerése és törlése
PdfFileEditor.ConcatenateKét vagy több PDF egyesítése egybe
PdfFileEditor.ExtractOldaltartomány kinyerése egy új PDF-be
PdfContentEditorOldaltartalom módosítása (szöveg, megjegyzések, műveletek)
PdfFileSignaturePDF digitális aláírások aláírása és ellenőrzése
PdfFileStampSzöveg vagy kép pecsétek átfedése az oldalakon
PdfConverterPDF oldalak renderelése raszteres képekké
FormattedTextStílusos szöveg leíró pecsét műveletekhez
FontStyleBetűstílusok felsorolása (félkövér, dőlt stb.)
EncodingTypeKarakterkódolás felsorolása

Lásd még

 Magyar