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 imagesTippek és legjobb gyakorlatok
- Mindig hívd meg a
Close()-t, vagy használd ausing-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 aTryAppend-t a nem Try változataik helyett a kifogásolható hibakezelés érdekében. - A felületek belsőleg a mag
Documentmodellnek delegálnak — válts a mag API-ra, ha finomhangolt vezérlésre van szükséged. - A
FormEditorfelü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
| Issue | Cause | Fix |
|---|---|---|
Save() üres fájlt hoz létre | BindPdf nem lett meghívva a mentés előtt | Mindig kössön egy forrás PDF-et, mielőtt meghívná a Save‑t |
| Az űrlapmező értéke nem íródik | A mező neve nem egyezik a PDF belső mezőnevével | Használja a Form.FieldNames‑t az elérhető mezőnevek listázásához |
| Az összefűzés csendben sikertelen | A bemeneti fájl titkosított vagy sérült | Használja a TryConcatenate‑t, és ellenőrizze a visszatérési értéket |
| Az aláírások érvénytelenek a szerkesztés után | A tartalom módosult az aláírás után | Aláí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 / Method | Description |
|---|---|
Form | AcroForm 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 |
PdfFileEditor | PDF oldaltartományok egyesítése, felosztása, kinyerése és törlése |
PdfFileEditor.Concatenate | Két vagy több PDF egyesítése egybe |
PdfFileEditor.Extract | Oldaltartomány kinyerése egy új PDF-be |
PdfContentEditor | Oldaltartalom módosítása (szöveg, megjegyzések, műveletek) |
PdfFileSignature | PDF digitális aláírások aláírása és ellenőrzése |
PdfFileStamp | Szöveg vagy kép pecsétek átfedése az oldalakon |
PdfConverter | PDF oldalak renderelése raszteres képekké |
FormattedText | Stílusos szöveg leíró pecsét műveletekhez |
FontStyle | Betűstílusok felsorolása (félkövér, dőlt stb.) |
EncodingType | Karakterkódolás felsorolása |