Jak linearyzowac PDFy za pomoca C# i IronPDF

Jak zapisac PDF jako linearyzowany?

Zapisanie dokumentu jako linearyzowanego PDF z IronPDF to proces szybki i latwy. Przed rozpoczeciem upewnij sie, ze zainstalowales IronPDF za pomoca NuGet lub jednej z innych dostepnych metod instalacji.

W tym przykladzie wyrenderujemy lancuch HTML do PDF za pomoca RenderHtmlAsPdf. Dla bardziej zlozonych dokumentow HTML warto rozwazyc funkcje konwersji HTML do PDF IronPDF. Nastepnie zapiszemy obiekt PdfDocument jako linearyzowany PDF korzystajac z metody instancyjnej SaveAsLinearized. Ta metoda przyjmuje argument typu string dla sciezki plikow wynikowych.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")

Proces linearyzacji restrukturyzuje wewnetrzny format PDFu, umieszczajac kluczowe informacje na poczatku pliku. To umozliwia progresywne pobieranie i renderowanie, co jest szczegolnie korzystne przy serwowaniu PDFow przez aplikacje webowe.

Jak wygląda wynik?

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-stream.cs

using IronPdf;
using System.IO;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>");

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Transform PDF bytes to a MemoryStream
MemoryStream memoryStream = new MemoryStream(pdfBytes);

// Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf");

Imports IronPdf
Imports System.IO

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>")

' Get the PDF binary data
Dim pdfBytes As Byte() = pdf.BinaryData

' Transform PDF bytes to a MemoryStream
Dim memoryStream As New MemoryStream(pdfBytes)

' Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf")

Jak moge zweryfikowac, czy PDF jest linearyzowany?

Oprocz sprawdzania wlasnosci dokumentu w przegladarce PDF, takiej jak Adobe Acrobat, aby sprawdzic, czy PDF jest linearyzowany, IronPDF rowniez oferuje mozliwosc weryfikacji tego programowo za pomoca metody IsLinearized. Metoda akceptuje parametr typu string dla sciezki pliku oraz opcjonalny drugi parametr typu string dla hasla, jesli PDF jest zaszyfrowany. Ta capable weryfikacji jest niezbedna dla zapewnienia jakosci i moze byc zintegrowana z workflowami testow automatycznych.

W tym przykladzie uzyjemy plikow wyjsciowych z trzech powyzszych przykladow, aby sprawdzic, czy sa one linearyzowane, oraz dolaczymy czwarty, nielinearyzowany PDF, aby pokazac dzialanie metody. Dla bardziej zaawansowanych technik manipulacji i weryfikacji PDFow, zbadz kompleksowy zestaw funkacji IronPDF.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-test.cs

using IronPdf;
using System;

// First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"));

// Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"));

// Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"));

// Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"));

Imports IronPdf
Imports System

' First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"))

' Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"))

' Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"))

' Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"))

Jakie sa wyniki?

Jak widzisz, pierwsze trzy przyklady zwracaja true, podczas gdy ostatni PDF, ktory nie jest linearyzowany, zwraca false.

Zwróć uwagęNie ma metody pozwalajacej sprawdzic, czy sam obiekt PdfDocument jest linearyzowany. Dzieje sie tak, poniewaz gdy plik PDF jest otwarty i zaladowany do obiektu, jego specjalna struktura linearyzowana jest utracona. Z tego samego powodu nie ma metody pozwalajacej zwrocic linearyzowanego PDFu w formie tablicy bajtow. Ta cecha linearyzowana istnieje jedynie jako zapisany plik na dysku.

Najlepsze praktyki dla linearyzowanych PDFow

Pracujac z linearyzowanymi PDFami, rozwaz te najlepsze praktyki:

1. Rozwazania dotyczace wielkosci plikow: linearyzacja moze nieznacznie zwiekszyc wielkosc pliku ze wzgledu na zrestrukturyzowany format. Uzyj funkcji kompresji IronPDF, aby zoptymalizowac wielkosc pliku, gdy to konieczne.

2. Wdrozenie Webowe: Linearyzowane PDFy sa idealne dla aplikacji webowych. Skonfiguruj swoj serwer webowy, aby obslugiwal zapytania o zakres bajtow, aby zmaksymalizowac korzysci z linearyzacji.

3. Testowanie wydajnosci: Zawsze testuj linearyzowane PDFy w docelowym srodowisku. Poprawa wydajnosci jest najbardziej zauwazalna dla duzych plikow przy wolniejszych polaczeniach.

4. Zgodnosc: Chociaz wiekszosc nowoczesnych przegladarek PDF wspiera linearyzowane PDFy, upewnij sie, ze sa zgodne z preferowanymi przegladarkami uzytkownikow.

Dla dodatkowych strategii optymalizacji i zaawansowanych technik obslugi PDFow, odwolaj sie do dokumentacji opcji renderowania IronPDF.