GroupDocs.Editor .NET でパスワード保護されたドキュメントをロードする

はじめに

プログラムでドキュメントを編集することは圧倒的に感じられることがあります。特に、さまざまな場所にある パスワード保護されたドキュメント ファイルを ロード する必要がある場合はなおさらです。ファイルがディスク上にあるか、バイトストリームから取得するか、データベースに保存されているかに関わらず、GroupDocs.Editor for .NET はこれらすべてのシナリオを処理できるクリーンで一貫した API を提供します。このガイドでは、前提条件の確認、必要な名前空間のインポート、そしてさまざまな方法でドキュメントをロードする手順（パスワード保護されたファイルの特別なケースを含む）をステップバイステップで説明します。

クイック回答

GroupDocs.Editor はパスワード保護されたファイルを開くことができますか？ はい、パスワードを設定した適切なロードオプションを使用してください。
サポートされている .NET バージョンは何ですか？ .NET Framework 2.0 以降および .NET Core/5/6 がすべて対応しています。
Editor オブジェクトを破棄する必要がありますか？ 絶対に必要です—Dispose() を呼び出してリソースを解放してください。
データベースからドキュメントをロードできますか？ はい、ファイルをバイト配列またはストリームとして取得し、Editor コンストラクタに渡します。
ファイルサイズに制限はありますか？ 大きなファイルもサポートされています。メモリ最適化オプションを使用したストリームベースのロードを検討してください。

「パスワード保護されたドキュメントをロードする」とは何ですか？

パスワード保護されたドキュメントをロードするとは、アクセスにパスワードが必要なファイルを開き、そのパスワードをプログラム上で提供して API が暗号を復号し、コンテンツを操作できるようにすることです。GroupDocs.Editor はロードオプションを通じて復号ステップを抽象化し、プロセスをシンプルにします。

なぜドキュメントのロードに GroupDocs.Editor を使用するのか？

統一された API – 同じコードで Word、Excel、PowerPoint、HTML ファイルを扱えます。
パスワード処理 – 手動で復号せずに暗号化ファイルをサポートします。
ストリームの柔軟性 – ファイルパス、ストリーム、データベースなど任意のカスタムソースからロードできます。
リソース管理 – シンプルな Dispose() パターンでメモリ使用量を抑えます。

前提条件

開始する前に、以下の前提条件が整っていることを確認してください：

Visual Studio – マシンに Visual Studio がインストールされていることを確認してください。
.NET Framework – GroupDocs.Editor for .NET は .NET Framework 2.0 以降をサポートします。プロジェクトが互換性のあるフレームワークを対象としていることを確認してください。
GroupDocs.Editor for .NET – 最新バージョンを download page からダウンロードしてください。
C# の基本知識 – このチュートリアルを進めるには C# と .NET プログラミングに慣れている必要があります。

名前空間のインポート

GroupDocs.Editor for .NET を使用し始めるには、プロジェクトに必要な名前空間をインポートする必要があります。C# ファイルの先頭に以下の using ディレクティブを追加してください。

using GroupDocs.Editor.Options;
using System.IO;

これらの名前空間は、ドキュメント編集タスクに必要なクラスとメソッドへのアクセスを提供します。

ステップ 1: ファイルパスからドキュメントをロードする

ファイルパスからドキュメントをロードするのは簡単です。この方法はローカルマシンに保存されたドキュメントに最適です。

string inputPath = "Your Sample Document";
// Load document as file via path and without load options
Editor editor1 = new Editor(inputPath);
// Dispose resources
editor1.Dispose();
System.Console.WriteLine("Document loaded successfully from file path.");

ステップ 2: ロードオプションを使用してドキュメントをロードする（パスワード保護されたファイル）

場合によっては、パスワード保護されたファイルなど、特別な処理が必要なドキュメントをロードする必要があります。そのような場合はロードオプションを使用できます。

string inputPath = "Your Sample Document";
// Create load options for Word documents
WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
wordLoadOptions.Password = "some password";
// Load document as file via path and with load options
Editor editor2 = new Editor(inputPath, delegate { return wordLoadOptions; });
// Dispose resources
editor2.Dispose();
System.Console.WriteLine("Password-protected document loaded successfully.");

ストリームからドキュメントをロードする方法

バイトストリームからドキュメントをロードするのは、ファイルとして保存されていないドキュメント（データベースや Web サービスから取得したものなど）を処理する際に便利です。

FileStream inputStream = File.OpenRead("Your Sample Document");
// Load document as content from byte stream and without load options
Editor editor3 = new Editor(delegate { return inputStream; });
// Dispose resources
editor3.Dispose();
System.Console.WriteLine("Document loaded successfully from byte stream.");

ステップ 4: バイトストリームからロードオプションを使用してドキュメントをロードする

バイトストリームからロードする際に特別な処理が必要なドキュメントについては、バイトストリームのロードとロードオプションを組み合わせることができます。

FileStream inputStream = File.OpenRead("Your Sample Document");
// Create load options for spreadsheets
SpreadsheetLoadOptions sheetLoadOptions = new SpreadsheetLoadOptions();
sheetLoadOptions.OptimizeMemoryUsage = true;
// Load document as content from byte stream and with load options
Editor editor4 = new Editor(delegate { return inputStream; }, delegate { return sheetLoadOptions; });
// Dispose resources
editor4.Dispose();
System.Console.WriteLine("Spreadsheet document loaded successfully with load options.");

データベースからドキュメントをロードする方法

ドキュメントがリレーショナルデータベースに保存されている場合、バイナリデータ（例: SELECT FileData FROM Documents WHERE Id = @id）を取得し、得られた byte[] または MemoryStream を Editor コンストラクタに渡します。これは上記のストリーム例と同様に、ソースに関係なくコードを一貫させます。

一般的な問題と解決策

パスワードが間違っている – エディタは例外をスローします。パスワードの値を確認し、ファイルタイプに適したロードオプションクラスを使用していることを確認してください。
ストリームがすでに閉じている – Editor インスタンスの存続期間中、ストリームが開いたままであることを確認するか、MemoryStream にコピーしてください。
大きなファイルでのメモリ消費 – SpreadsheetLoadOptions.OptimizeMemoryUsage = true（上記参照）や他のフォーマットに対応する同等のオプションを使用してください。

よくある質問

Q: GroupDocs.Editor for .NET がサポートしているファイル形式は何ですか？
A: GroupDocs.Editor は DOCX、XLSX、PPTX、HTML など多数のファイル形式をサポートしています。完全な一覧は documentation を参照してください。

Q: パスワード保護されたドキュメントはどのように扱いますか？
A: WordProcessingLoadOptions などのロードオプションを使用して、パスワード保護されたドキュメントをロードする際にパスワードを指定できます。

Q: GroupDocs.Editor を Web アプリケーションで使用できますか？
A: はい、GroupDocs.Editor は Web アプリケーションでも使用できます。ファイルストリームとリソースの破棄を適切に処理し、メモリリークを防いでください。

Q: GroupDocs.Editor の一時ライセンスはどこで取得できますか？
A: 一時ライセンスは temporary license page から取得できます。

Q: 問題が発生した場合のサポートはありますか？
A: はい、GroupDocs は support forum を通じてサポートを提供しています。

Q: データベースからロードする際に特別な設定は必要ですか？
A: バイナリデータを取得し、ストリームまたはバイト配列として Editor コンストラクタに渡す以外に特別な設定は不要です。

Q: 非常に大きなスプレッドシートをロードする際のパフォーマンスはどう向上させますか？
A: SpreadsheetLoadOptions.OptimizeMemoryUsage = true のようなメモリ最適化オプションを有効にして、メモリフットプリントを削減してください。

結論

おめでとうございます！GroupDocs.Editor for .NET を使用して、ローカルファイル、パスワード保護されたドキュメント、バイトストリーム、データベース保存コンテンツなど、さまざまな方法で パスワード保護されたドキュメント をロードする方法を習得しました。常に Editor インスタンスを破棄して、アプリケーションのパフォーマンスとリソース効率を保つことを忘れないでください。

Last Updated: 2026-04-20
Tested With: GroupDocs.Editor 2.0 (latest)
Author: GroupDocs