1. IronPDF
  2. ハウツー
  3. PDFを線形化する

C#を使ってIronPDFでPDFをリニアライズする方法

カーティス・チャウ
カーティス・チャウ
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

線形化されたPDFは、"高速Webビュー"または"Web最適化PDF"とも呼ばれ、インターネットストリーミング用に構造的に再編成されています。 これにより、互換性のあるビューアがドキュメントの最初のページを、ファイル全体がダウンロードされる前にほぼ瞬時に表示できます。

ミッションクリティカルまたは時間に敏感なアプリケーションでは、この機能は特に有用です。 特に遅いまたはモバイルネットワーク上で、大きなドキュメントの読み込み時間を排除し、ユーザーがすぐにコンテンツと対話できるようにします。 これにより、迅速な意思決定が可能になり、プロの環境での生産性が向上します。

このハウツー記事では、IronPDFが開発者に提供する選択肢を探索し、ドキュメントを線形PDFとしてエクスポートします。

見出し:2(クイックスタート: Web表示を高速化するためのPDFの線形化)

IronPDFを使って、PDFを簡単に線形化する方法を始めましょう。 この簡単なコード例は、IronPDFのLinearizePdfメソッドを使用して、PDFをWebブラウザでの高速読み込み用に最適化する方法を示しています。 ページをロードに合わせて表示できるようにすることで、全体の読み込みを待つのではなく、ユーザーエクスペリエンスを向上させます。 以下の手順に従って、PDFを合理化し、オンライン共有のためにより効率的にします。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して 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. PDFが線形化されているかどうかをIsLinearizedで確認してください。


線形化PDFとして保存

IronPDFでドキュメントを線形化PDFとして保存するのは、迅速で簡単なプロセスです。 この例では、RenderHtmlAsPdfを使用してHTML文字列をPDFにレンダリングします。 その後、SaveAsLinearizedインスタンスメソッドを使用してPdfDocumentオブジェクトを線形化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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

高速ウェブ表示 PDF

線形化PDFバイト数として保存

PdfDocumentオブジェクトを直接保存するだけでなく、IronPDFはPDFバイト配列を線形化PDFに変換することもできます。 この例では、HTML文字列をPdfDocumentオブジェクトにレンダリングし、そのバイト配列を取得し、それを線形化PDFとして保存する方法を実演します。 このSaveAsLinearizedメソッドは、ソースドキュメントが暗号化されている場合、オプショナルな第3の文字列パラメーターとしてパスワードを受け取ることもできます。

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-bytes.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");

IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

これはコードによって生成されたファイルです：

線形化PDFメモリストリームとして保存

SaveAsLinearizedメソッドは、ストリームオブジェクトを入力として受け取ることもできます。 この例では、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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

これはコードによって生成されたファイルです：

PDFが線形化されているか確認する

Adobe AcrobatなどでPDFビューアのドキュメントプロパティを確認する以外にも、IronPDFはこのチェックをプログラムで行うためのIsLinearizedメソッドを提供しています。 このメソッドは、ファイルパスの文字列パラメータと、PDFが暗号化されている場合、オプショナルな第2の文字列パラメータとしてパスワードを受け取ります。

この例では、上記の3つの例からの出力ファイルを使用して、それらが線形化されているかどうかをテストし、メソッドの動作を示すために4つ目の非線形化PDFを含めます。

: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"));
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

リニアライズされた結果

ご覧のように、最初の3つの例はtrueを返しますが、最後のPDFは、線形化されていないためfalseを返します。

BRACKET-i-OPEN--PdfDocumentオブジェクト自体が線形化されているかどうかをチェックするメソッドがありません。 これは、PDFファイルが開かれてオブジェクトにロードされたとき、その特別な線形化構造が失われるためです。同じ理由で、線形化PDFをバイト配列として返す方法もありません。 このリニアライズされた機能は、ディスク上に保存されたファイルとしてのみ存在します。

よくある質問

PDFを線形化するとはどういう意味ですか？

PDFをリニア化すること、つまりFast Web Viewとして知られているプロセスは、PDFファイルをウェブ用に最適化し、構造を整理してより速い読み込み時間を可能にすることです。これは、オンラインでアクセスする必要のある大きな文書に特に便利です。

なぜPDFを線形化する必要があるのですか？

PDFを線形化することで、特にインターネットを介して表示される場合には、ドキュメントのコンテンツへのアクセスを迅速化し、ユーザーエクスペリエンスを向上させます。これにより、大きなドキュメントに対して、ファイル全体がダウンロードされる前に最初のページを表示することが可能になります。

IronPDFはどのようにPDFファイルの線形化を助けますか？

IronPDFはC#コードを使用してPDFファイルを線形化するためのシンプルな方法を提供します。それにより、開発者はPDFの構造を最適化してWebパフォーマンスを改善し、ユーザーがより迅速にドキュメントにアクセスし表示できるようにします。

線形化のプロセスは元に戻せますか？

はい、線形化のプロセスは元に戻せますが、それにはファイル構造を非線形化されたフォーマットに戻す作業が必要です。IronPDFはPDFファイルを操作することができ、どのように最適化され表示されるかをコントロールすることができます。

開発者でなくてもIronPDFを使用してPDFを線形化できますか？

IronPDFはC#と一緒に使用される開発者ツールですが、限定的なコーディング経験しか持たない人でもPDFを効果的に線形化するのに役立つ明確なドキュメントと例を提供しています。

IronPDFを使用してPDFを線形化すると性能にどのような利点がありますか？

IronPDFはPDFをより速くロードできるように最適化します。特にWeb上での改善は、ユーザーエクスペリエンスとアクセシビリティを向上させる上で重要であり、特に遅いインターネット接続を持つユーザーにとって重要です。

線形化されたPDFを表示するために特殊なソフトウェアが必要ですか？

線形化されたPDFを表示するために特殊なソフトウェアは必要ありません。それらは標準のPDFリーダーで開くことができます。線形化の利点は主にオンラインでのアクセス時により速いロード時間にあります。

IronPDF の線形化は .NET 10 プロジェクトでサポートされていますか?

はい。IronPDFは.NET 10と完全に互換性があり、線形化機能（SaveAsLinearizedやIsLinearizedなど）は特別な設定なしで動作します。これらのメソッドは、以前のサポートバージョンと同様に、.NET 10アプリケーションでも使用できます。

カーティス・チャウ
カーティス・チャウ
  今すぐエンジニアリングチームとチャット
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？
Nuget ダウンロード 16,493,056 | Version: 2025.11 リリース