Jak kompresować pliki PDF w C# używając IronPDF

Curtis Chau

Updated: 29 czerwca 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronPDF kompresuje PDF w C# za pomocą metody CompressAndSaveAs, która przekodowuje osadzone obrazy jako JPEG i opcjonalnie usuwa strukturę drzewa PDF, aby zmniejszyć rozmiar pliku w jednym wywołaniu. Metody towarzyszące CompressPdfToBytes i CompressPdfToStream wykonują to samo zadanie w pamięci, gdy nigdy nie chcesz dotykać dysku.

Obrazy zwykle stanowią większość rozmiaru pliku PDF, a dokumenty z dużą ilością tabel mają drzewo struktury, które dodatkowo zwiększa wagę. IronPDF celuje w oba, więc to samo wywołanie działa na plikach PDF załadowanych z dysku lub przechowywanych w strumieniu pamięci.

Załaduj swój PDF za pomocą PdfDocument.FromFile i wywołaj CompressAndSaveAs, aby przekodować jego obrazy i zapisać zredukowaną kopię w jednym kroku. Drugi argument to jakość JPEG.

Jak skompresować obrazy w plikach PDF?

Przekaż wartość JPEG quality jako drugi argument do CompressAndSaveAs, a IronPDF przekoduje każdy osadzony obraz w tej jakości. Wartości wahają się od 0 (maksymalna kompresja) do 100 (minimalna strata), a podstawowa jednostka decyduje, jak każda wartość przypisuje się do wynikowego obrazu. Ta metoda najlepiej nadaje się do dokumentów z osadzonymi obrazami.

Jako ogólny przewodnik:

• 90 i wyżej: wysoka jakość
• 80 do 90: średnia jakość
• 70 do 80: niska jakość

Niższa liczba bardziej kompresuje, ale może wprowadzić widoczne artefakty, a spadek przejrzystości zależy od obrazu źródłowego, więc przetestuj kilka ustawień na własnym materiale, aby znaleźć równowagę, którą chcesz.

Dane wejściowe

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Quality 40 re-encodes every embedded image as a low-quality JPEG, which is
// where most of the file-size saving comes from in image-heavy PDFs
pdf.CompressAndSaveAs("compressed.pdf", 40);

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Quality 40 re-encodes every embedded image as a low-quality JPEG, which is
// where most of the file-size saving comes from in image-heavy PDFs
pdf.CompressAndSaveAs("compressed.pdf", 40);

Wynik

Jakich rezultatów mogę oczekiwać po kompresji obrazów?

Zmniejszono o 39,24% w przypadku renderowania Wikipedii.

Jak skompresować strukturę drzewa pliku PDF?

Przekaż removeStructureTree: true jako trzeci argument do CompressAndSaveAs, aby usunąć strukturę drzewa, którą silnik Chrome zapisuje w pliku PDF. Oszczędności są największe na plikach PDF z silnika Chrome, które zawierają rozległe dane tabelaryczne. Niektóre silniki renderujące nie emitują takiej struktury, co powoduje, że funkcja nie ma czego usunąć.

Usunięcie drzewa może osłabić podświetlanie tekstu i wybór, więc rozważ to przeciw oszczędności miejsca, jeśli czytniki będą później musiały wyodrębniać tekst i obrazy z wyniku.

Przetestuj CompressAndSaveAs z usunięciem struktury drzewa, używając tego PDF z danymi tabeli.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("table.pdf");

// Pass null quality to skip image compression and true to drop the structure
// tree, which is the bulk of the size in table-heavy Chrome-rendered PDFs
pdf.CompressAndSaveAs("compressedTable.pdf", null, true);

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("table.pdf");

// Pass null quality to skip image compression and true to drop the structure
// tree, which is the bulk of the size in table-heavy Chrome-rendered PDFs
pdf.CompressAndSaveAs("compressedTable.pdf", null, true);

Jakie zmniejszenie rozmiaru pliku można osiągnąć dzięki kompresji struktury drzewa?

Zmniejszono o 67,90%. Wskaźnik rośnie wraz ze wzrostem pliku tabeli PDF.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak mogę zastosować obie metody kompresji jednocześnie?

Podaj wartość quality i ustaw removeStructureTree na true w tej samej funkcji CompressAndSaveAs, aby jednocześnie zmniejszyć oba źródła nadmiarowych danych. To powiązanie sprawdza się w dokumentach, które łączą obrazy ze strukturalnymi danymi, takich jak raporty z wykresami czy faktury z osadzonymi tabelami.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Shrink both sources of bloat in one pass: re-encode images at quality 80
// and strip the structure tree (true) for the largest size reduction
pdf.CompressAndSaveAs("compressed.pdf", 80, true);

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Shrink both sources of bloat in one pass: re-encode images at quality 80
// and strip the structure tree (true) for the largest size reduction
pdf.CompressAndSaveAs("compressed.pdf", 80, true);

Jakie parametry akceptuje CompressAndSaveAs?

• outputPath (string): Ścieżka do pliku, gdzie zapisany jest skompresowany PDF.

• quality (int?, od 0 do 100): Jakość JPEG stosowana do każdego osadzonego obrazu. Niższe wartości powodują tworzenie mniejszych plików. Przekaż null, aby całkowicie pominąć kompresję obrazu.

• removeStructureTree (bool, domyślnie false): Gdy true, usuwa strukturę drzewa PDF, aby dodatkowo zmniejszyć rozmiar pliku. Najbardziej efektywne dla plików PDF generowanych z HTML z tabelami.

Niech przypadek użycia ustawi knoba. Kopie archiwalne często preferują jakość nad rozmiarem, podczas gdy dystrybucja w sieci nagradza mniejszy plik. To samo przemienne odniesienie odnosi się, gdy kompresujesz dokumenty zgodne z PDF/A, gdzie wierność obrazów może być priorytetem.

Jak mogę uzyskać szczegółowe sterowanie kompresją?

Dla większości dokumentów wystarczające jest wywołanie dwoma argumentami, ale archiwa z dużą ilością obrazów i ścisłe budżety wielkości czasami wymagają większej kontroli. Przekaż obiekt AdvancedCompressionOptions do CompressAndSaveAs, aby dostosować potok kompresji, w tym skalowanie w dół DPI obrazów, jakość ponownego kodowania JPEG i poziom kompresji zlib. Prostsze przeciążenie CompressAndSaveAs(outputPath, quality, removeStructureTree) nadal działa bez zmian i generuje takie samo wyjście jak wcześniej.

using IronPdf;

var pdf = PdfDocument.FromFile("input.pdf");

// Web or email: strong size reduction
pdf.CompressAndSaveAs("compressed.pdf", new AdvancedCompressionOptions
{
    JpegQuality = 70,
    TargetImageDpi = 150,
    RemoveStructureTree = true
});

// Print quality: minimal quality loss
pdf.CompressAndSaveAs("print.pdf", new AdvancedCompressionOptions
{
    JpegQuality = 90,
    TargetImageDpi = 300
});

using IronPdf;

var pdf = PdfDocument.FromFile("input.pdf");

// Web or email: strong size reduction
pdf.CompressAndSaveAs("compressed.pdf", new AdvancedCompressionOptions
{
    JpegQuality = 70,
    TargetImageDpi = 150,
    RemoveStructureTree = true
});

// Print quality: minimal quality loss
pdf.CompressAndSaveAs("print.pdf", new AdvancedCompressionOptions
{
    JpegQuality = 90,
    TargetImageDpi = 300
});

Dwie właściwości, które mają największy wpływ, to JpegQuality i TargetImageDpi:

• JpegQuality (int?, od 1 do 100, domyślnie null): Przekodowuje obrazy w tej jakości JPEG. Pozostaw je null, aby całkowicie pominąć ponowne kodowanie obrazu.
• TargetImageDpi (int?, domyślnie 150): Skalowanie w dół obrazów, których efektywne DPI przekracza tę wartość przed ponownym kodowaniem. Ustaw je na null lub 0, aby wyłączyć zmniejszanie rozdzielczości i zachować oryginalną.

Zalecane wartości JpegQuality (dotyczy tylko gdy ustawione):

Zalecane wartości TargetImageDpi (stratne):

Jak skompresować pliki PDF bez zapisywania ich na dysku?

Odpowiedzi API, funkcje w chmurze i załączniki e-mail rzadko potrzebują skompresowanego PDF na dysku. CompressPdfToBytes zwraca wynik jako tablica bajtów, więc Ty decydujesz, gdzie bajty trafią dalej.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Return the compressed PDF as bytes so it can go straight into an HTTP
// response, a database varbinary column, or a queue message with no temp file
byte[] compressedBytes = pdf.CompressPdfToBytes();

File.WriteAllBytes("compressed.pdf", compressedBytes);

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Return the compressed PDF as bytes so it can go straight into an HTTP
// response, a database varbinary column, or a queue message with no temp file
byte[] compressedBytes = pdf.CompressPdfToBytes();

File.WriteAllBytes("compressed.pdf", compressedBytes);

Jeśli potrzebujesz Stream zamiast tablicy bajtów, wywołaj CompressPdfToStream i skopiuj to do swojej destynacji. To pasuje do przesyłania danych do korpusu odpowiedzi HTTP, przesyłania do chmury lub wszelkich przepływów pracy opartych na strumieniach.

using IronPdf;
using System.IO;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stream output so the compressed bytes can be piped straight to an HTTP
// response or cloud upload without first buffering the whole file as byte[]
using Stream compressedStream = pdf.CompressPdfToStream();

// CompressPdfToStream returns a read-only Stream, so copy it to the destination
using FileStream fileStream = File.Create("compressed.pdf");
compressedStream.CopyTo(fileStream);

using IronPdf;
using System.IO;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stream output so the compressed bytes can be piped straight to an HTTP
// response or cloud upload without first buffering the whole file as byte[]
using Stream compressedStream = pdf.CompressPdfToStream();

// CompressPdfToStream returns a read-only Stream, so copy it to the destination
using FileStream fileStream = File.Create("compressed.pdf");
compressedStream.CopyTo(fileStream);

Jakie opcje CompressionTryb są dostępne?

Zarówno CompressPdfToBytes, jak i CompressPdfToStream przyjmują opcjonalny argument CompressionTryb, który decyduje, jak zadanie będzie wykonywane. Docelowe platformy wdrożenia różnią się, czy pozwalają na dostęp do dysku, a tryb pozwala wybrać odpowiedni kompromis:

Automatic próbuje najpierw HighQuality, a następnie spada do FastMemory, gdy katalog tymczasowy jest niedostępny. Przykład poniżej wymusza HighQuality dla najmniejszego wyjścia, które wymaga dostępu zapisu do systemowego katalogu temp w czasie działania.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// HighQuality resamples images using the system temp directory, so it produces
// the smallest output but needs write access to that directory at runtime
byte[] compressedBytes = pdf.CompressPdfToBytes(50, false, CompressionMode.HighQuality);

File.WriteAllBytes("compressed.pdf", compressedBytes);

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// HighQuality resamples images using the system temp directory, so it produces
// the smallest output but needs write access to that directory at runtime
byte[] compressedBytes = pdf.CompressPdfToBytes(50, false, CompressionMode.HighQuality);

File.WriteAllBytes("compressed.pdf", compressedBytes);

Wynik

CompressPdfToBytes i CompressPdfToStream są teraz dostępne na wszystkich platformach IronPDF, w tym Java, Niede.js i Python.

Wnioski

Masz teraz jedną metodę, CompressAndSaveAs, która ponownie koduje obrazy i zdziera strukturę drzewa, plus CompressPdfToBytes i CompressPdfToStream dla tej samej pracy w pamięci pod wybranym CompressionTryb. Naturalnym następnym krokiem jest przekształcenie odchudzonych stron na miniatury za pomocą rasteryzacji PDF.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej