IronPDF를 사용하여 C#으로 PDF를 선형화하는 방법

PDF 파일을 선형화된 형식으로 저장하려면 어떻게 해야 하나요?

IronPDF를 사용하여 문서를 선형화된 PDF로 저장하는 것은 빠르고 간편한 과정입니다. 시작하기 전에 NuGet 또는 기타 사용 가능한 설치 방법을 통해 IronPDF가 설치 되었는지 확인하십시오.

이 예제에서는 RenderHtmlAsPdf를 사용하여 HTML 문자열을 PDF로 렌더링합니다. 좀 더 복잡한 HTML 문서의 경우, IronPDF의 HTML을 PDF로 변환하는 기능을 살펴보는 것이 좋습니다. 그 후, PdfDocument 객체를 SaveAsLinearized 인스턴스 메서드를 사용하여 선형화된 PDF로 저장합니다. 이 메서드는 출력 파일 경로에 대한 문자열 인수를 받습니다.

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

선형화 과정은 PDF의 내부 형식을 재구성하여 중요한 정보를 파일의 시작 부분에 배치합니다. 이를 통해 점진적인 다운로드 및 렌더링이 가능해지며, 특히 웹 애플리케이션을 통해 PDF를 제공할 때 유용합니다.

출력 결과는 어떻게 나타나나요?

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

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

PDF 파일이 선형화되었는지 어떻게 확인할 수 있나요?

PDF가 선형화되었는지 확인하기 위해 Adobe Acrobat과 같은 PDF 뷰어에서 문서 속성을 확인하는 것 외에도 IronPDF는 IsLinearized 메서드를 사용하여 프로그래밍 방식으로 이를 확인할 수 있는 방법도 제공합니다. 이 메서드는 파일 경로를 나타내는 문자열 매개변수와 PDF가 암호화된 경우 암호를 나타내는 선택적 두 번째 문자열 매개변수를 받습니다. 이러한 검증 기능은 품질 보증에 필수적이며 자동화된 테스트 워크플로에 통합될 수 있습니다.

이 예제에서는 위 세 가지 예제의 출력 파일을 사용하여 선형화 여부를 테스트하고, 네 번째 예제인 비선형화된 PDF를 포함하여 해당 메서드의 동작을 보여드리겠습니다. 보다 고급적인 PDF 조작 및 검증 기술을 활용하려면 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"));

결과는 무엇인가요?

보시다시피, 처음 세 예제는 true를 반환하는 반면, 선형화되지 않은 마지막 PDF는 false를 반환합니다.

[{i:(PdfDocument 객체 자체가 선형화되었는지 확인하는 방법은 없습니다. PDF 파일을 열고 객체에 로드할 때, 특수한 선형화 구조가 손실되기 때문입니다. 같은 이유로 선형화된 PDF를 바이트 배열로 반환하는 메서드는 존재하지 않습니다. 이 선형화된 기능은 디스크에 저장된 파일로만 존재합니다.

선형화된 PDF를 위한 모범 사례

선형화된 PDF를 다룰 때는 다음과 같은 모범 사례를 고려하십시오.

1. 파일 크기 고려 사항 : 선형화는 재구성된 형식으로 인해 파일 크기를 약간 증가시킬 수 있습니다. 필요에 따라 IronPDF의 압축 기능을 사용하여 파일 크기를 최적화하세요.

2. 웹 배포 : 선형화된 PDF는 웹 애플리케이션에 이상적입니다. 선형화의 이점을 극대화하려면 웹 서버가 바이트 범위 요청을 지원하도록 구성하십시오.

3. 성능 테스트 : 선형화된 PDF는 항상 대상 환경에서 테스트해야 합니다. 성능 향상은 특히 속도가 느린 인터넷 연결에서 대용량 파일을 처리할 때 가장 두드러지게 나타납니다.

4. 호환성 : 대부분의 최신 PDF 뷰어는 선형화된 PDF를 지원하지만, 사용자가 선호하는 뷰어와의 호환성도 확인해야 합니다.

추가적인 최적화 전략 및 고급 PDF 처리 기술에 대해서는 IronPDF의 렌더링 옵션 설명서를 참조하십시오.