API fasad

Fasady API

API Facades zapewnia uproszczone, zadaniowo‑zorientowane opakowania wokół podstawowego modelu obiektowego Aspose.PDF FOSS for .NET. Każda klasa fasady jest skierowana do konkretnej operacji PDF — wypełniania formularzy, łączenia plików, edycji treści lub podpisywania cyfrowego — i udostępnia przepływ pracy BindPdf / Save.

Wypełnianie formularza przy użyciu fasady Form

Form (w Aspose.Pdf.Facades) wiąże się z istniejącym PDF i pozwala odczytywać lub zapisywać wartości pól AcroForm bez nawigacji po drzewie stron.

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

Aby odczytać wartości pól:

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

Łączenie i rozdzielanie plików PDF przy użyciu PdfFileEditor

PdfFileEditor konkatenuje, dzieli, wyodrębnia i usuwa zakresy stron.

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

Edycja treści strony przy użyciu PdfContentEditor

PdfContentEditor modyfikuje istniejącą zawartość strony — dodaje tekst, zastępuje tekst lub dołącza akcje do adnotacji.

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

Podpisy cyfrowe przy użyciu PdfFileSignature

PdfFileSignature podpisuje dokumenty PDF i weryfikuje istniejące podpisy.

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

Stemplowanie stron przy użyciu PdfFileStamp

PdfFileStamp nakłada tekst, obrazy lub inne strony PDF jako pieczątki.

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

Konwertowanie stron na obrazy przy użyciu PdfConverter

PdfConverter renderuje strony PDF do formatów obrazów rastrowych.

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

Porady i najlepsze praktyki

• Zawsze wywołuj Close() lub używaj using, aby zwolnić zasoby trzymane przez obiekty fasady.
• Używaj BindPdf z ścieżką do pliku dla dużych plików, aby uniknąć ładowania wszystkiego do pamięci jednocześnie.
• Preferuj TryConcatenate i TryAppend zamiast ich nie‑Try odpowiedników, aby zapewnić łagodną obsługę błędów.
• Fasady delegują wewnętrznie do podstawowego modelu Document — przełącz się na rdzeniowe API, gdy potrzebna jest szczegółowa kontrola.
• Fasada FormEditor umożliwia dodawanie nowych pól formularza do istniejącego PDF, a nie tylko wypełnianie istniejących.

Typowe problemy

Najczęściej zadawane pytania

Jaka jest różnica między Facades a core Document API?

Fasady udostępniają wysokopoziomowe, zadaniowo zorientowane metody (wypełnianie formularza, scalanie plików).
Podstawowe API (Document, Page, Annotation) zapewnia dostęp na niższym poziomie do
każdego obiektu PDF. Fasady używają podstawowego API wewnętrznie.

Czy mogę łączyć wiele operacji fasady?

Tak. Powiąż to samo źródło, wykonaj operacje i zapisz raz. Lub zapisz wynik pośredni i ponownie powiąż go dla kolejnej operacji.

Czy PdfFileEditor obsługuje pliki PDF zabezpieczone hasłem?

Tak. Przeciążenia akceptujące hasła właściciela/użytkownika są dostępne dla zaszyfrowanych plików.

Podsumowanie odniesień API

Zobacz także

• Aspose.PDF for .NET Produkt Enterprise