1. IronPDF
  2. 방법
  3. PDF를 선형화합니다

IronPDF 사용하여 C#으로 PDF를 선형화하는 방법 — PDF 압축 및 PDF 편집

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

선형화된 PDF는 다운로드 중에 첫 페이지를 즉시 표시할 수 있어 대용량 문서의 사용자 경험을 크게 향상시킵니다. IronPDF C#으로 선형화된 PDF를 생성하고 검증하는 간단한 방법을 제공하여 웹에서 빠르게 볼 수 있도록 PDF 압축 및 문서 최적화를 수행합니다. 이 PDF 편집 기능을 통해 기존 PDF 파일을 효율적으로 최적화할 수 있습니다.

선형화된 PDF는 "빠른 웹 보기" 또는 "웹 최적화 PDF"라고도 하며, 인터넷 스트리밍에 맞게 구조가 재구성된 PDF입니다. 이를 통해 호환되는 뷰어는 전체 파일 다운로드가 완료되기 훨씬 전에 문서의 첫 페이지를 거의 즉시 표시할 수 있습니다.

임무 수행에 매우 중요하거나 시간에 민감한 애플리케이션에서 이 기능은 특히 유용합니다. 이 기능은 특히 속도가 느리거나 모바일 네트워크에서 대용량 문서를 로드할 때 발생하는 답답한 로딩 시간을 없애주어 사용자가 콘텐츠와 즉시 상호 작용할 수 있도록 합니다. 이는 의사결정을 신속하게 내릴 수 있도록 도와주고 업무 환경에서 생산성을 향상시킵니다. IronPDF의 성능 최적화 기능 과 결합된 선형화된 PDF는 탁월한 보기 환경을 제공합니다.

이 사용 설명서에서는 IronPDF 개발자에게 제공하는 문서 선형화 PDF 내보내기 옵션을 살펴보겠습니다.

빠른 시작: 웹에서 더 빠르게 보기 위해 PDF를 선형화하세요

IronPDF 사용하여 PDF를 손쉽게 선형화해 보세요. 이 간단한 코드 예제는 IronPDF의 LinearizePdf 메소드를 사용하여 웹 브라우저에서 빠르게 로딩하도록 PDF를 최적화하는 방법을 보여줍니다. 전체 문서가 다운로드될 때까지 기다리지 않고 페이지가 로드되는 즉시 표시되도록 하여 사용자 경험을 향상시키세요. 아래 단계를 따라 PDF 파일을 간소화하고 온라인 공유에 더욱 효율적으로 활용하세요.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPdf 설치하기

    PM > Install-Package IronPdf

  2. 다음 코드 조각을 복사하여 실행하세요.

    var pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.SaveAsLinearized(pdf.BinaryData, "linearized.pdf");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기

    arrow pointer

최소 워크플로우(5단계)

  1. NuGet 에서 IronPDF C# 라이브러리를 다운로드하세요.
  2. PDF 렌더러를 인스턴스화하고 HTML 문자열을 전달합니다.
  3. `RenderHtmlAsPdf` 사용하여 HTML 문자열을 렌더링합니다.
  4. `SaveAsLinearized` 사용하여 PDF를 선형화된 PDF로 저장합니다.
  5. `IsLinearized` 함수를 사용하여 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");
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")
$vbLabelText   $csharpLabel

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

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

PDF 속성 대화 상자에서 빠른 웹 보기 설정이 강조 표시되어 선형화된 PDF 최적화를 보여줍니다.

PDF 바이트를 선형화된 형식으로 저장하려면 어떻게 해야 하나요?

직접 PdfDocument 객체를 저장하는 것 외에도, IronPDF는 사용자가 PDF 바이트 배열을 선형화된 PDF로 변환할 수 있도록 합니다. 이러한 유연성은 데이터베이스에 저장된 PDF 파일을 다루거나 메모리 사용량이 많은 애플리케이션에서 PDF 파일을 처리할 때 특히 유용합니다. 메모리에서 PDF를 사용하는 방법에 대한 자세한 내용은 메모리 스트림에서 PDF를 로드하는 방법 에 대한 가이드를 참조하세요.

이 예제에서는 HTML 문자열을 PdfDocument 객체로 렌더링한 후, 그 바이트 배열을 추출하여 선형화된 PDF로 저장하는 방법을 시연할 것입니다. 이 SaveAsLinearized 메소드는 소스 문서가 암호화된 경우를 대비하여 비밀번호를 위한 선택적 세 번째 문자열 매개변수도 허용합니다.

: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")
$vbLabelText   $csharpLabel

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

다음은 해당 코드가 생성한 파일입니다.

메모리 스트림을 선형화된 형태로 저장하려면 어떻게 해야 하나요?

SaveAsLinearized 메소드는 다양한 애플리케이션 아키텍처에 최대의 유연성을 제공하기 위해 입력으로 스트림 객체를 받을 수도 있습니다. 이 기능은 클라우드 서비스와 통합하거나 임시 파일을 다룰 때 필수적입니다. 고급 시나리오를 위해 PDF를 메모리로 내보내는 방법 에 대해 자세히 알아보세요.

이 예제에서는 PdfDocument 객체를 바이트 배열로 변환하고, 그것을 MemoryStream에 기록한 다음 이 기능을 시연하기 위해 스트림을 선형화된 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")
$vbLabelText   $csharpLabel

이 접근 방식은 임시 파일을 다루거나 중간 파일을 디스크에 저장하지 않고 PDF를 처리해야 할 때 특히 유용하며, 성능과 보안을 모두 향상시킵니다.

다음은 해당 코드가 생성한 파일입니다.

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

Adobe Acrobat 등과 같은 PDF 뷰어에서 문서 속성을 확인하여 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"));
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"))
$vbLabelText   $csharpLabel

결과는 무엇인가요?

PDF 선형화 결과를 보여주는 디버그 출력: 참 값 3개와 거짓 값 1개

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

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

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

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

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

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

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

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

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

자주 묻는 질문

선형화된 PDF란 무엇이며 왜 사용해야 할까요?

선형화된 PDF는 '빠른 웹 보기' 또는 '웹 최적화 PDF'라고도 하며, 인터넷 스트리밍에 최적화되도록 구조가 재구성됩니다. IronPDF의 선형화 기능은 호환되는 뷰어에서 첫 페이지를 거의 즉시 표시하고 나머지 페이지는 다운로드할 수 있도록 하여, 특히 속도가 느리거나 모바일 네트워크 환경에서 대용량 문서를 볼 때 사용자 경험을 크게 향상시킵니다.

C#에서 선형화된 PDF를 어떻게 생성하나요?

IronPDF를 사용하면 SaveAsLinearized 메서드를 통해 선형화된 PDF를 쉽게 생성할 수 있습니다. PDF 문서를 불러오거나 생성한 다음, pdf.SaveAsLinearized(pdf.BinaryData, 'output.pdf')를 호출하여 웹에서 빠르게 볼 수 있도록 최적화된 선형화된 PDF로 저장하면 됩니다.

기존 PDF 파일을 선형화된 형식으로 변환할 수 있나요?

네, IronPDF를 사용하면 기존 PDF 파일을 선형화된 형식으로 변환할 수 있습니다. PdfDocument.FromFile('input.pdf')를 사용하여 PDF 파일을 불러온 다음, SaveAsLinearized 메서드를 사용하여 웹 성능 향상을 위해 선형화된 PDF로 저장할 수 있습니다.

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

IronPDF는 PDF가 선형화되었는지 확인하는 IsLinearized 속성을 제공합니다. PDF 문서를 불러온 후 IsLinearized 부울 속성을 확인하여 문서가 웹에서 빠르게 볼 수 있도록 최적화되었는지 여부를 확인할 수 있습니다.

웹 애플리케이션에서 PDF를 선형화할 때 얻을 수 있는 주요 이점은 무엇입니까?

IronPDF를 사용하여 PDF를 선형화하면 첫 페이지가 즉시 표시되고, 대용량 문서의 로딩 시간 지연 문제가 해결되며, 업무 환경에서 더 빠른 의사 결정을 지원하고, 특히 중요하거나 시간 제약이 있는 애플리케이션에서 사용자 경험을 크게 향상시킬 수 있습니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 18,318,263 | 버전: 2026.4 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPdf
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.