無効なフォームフィールドコレクションを修正して保存する

導入

ようこそ! ドキュメント内のフォームフィールドを操作していて、無効なフォームフィールドコレクションに関する問題に直面している場合は、適切な場所にいます。このチュートリアルでは、Groupdocs.Editor for .NET を使用して無効なフォームフィールドを修正し、ドキュメントを保存する方法について詳しく説明します。このプロセスを段階的にガイドし、シームレスに動作させるために必要なすべての詳細を提供します。さあ、始めましょう!

前提条件

コードに進む前に、準備しておくべきことがいくつかあります。

Groupdocs.Editor for .NET: Groupdocs.Editorライブラリが.NET用にインストールされていることを確認してください。ダウンロードできます。ここ.
開発環境: Visual Studio などの .NET 開発環境をセットアップする必要があります。
C# の基本知識: このチュートリアルでは、C# プログラミングの基本を理解していることを前提としています。

名前空間のインポート

まず、C# プロジェクトに必要な名前空間をインポートする必要があります。コードファイルの先頭に次の行を追加します。

using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
using GroupDocs.Editor.Words.FieldManagement;
using System;
using System.IO;

ステップ1: 入力ファイルのパスを取得する

最初のステップは、入力ファイルへのパスを指定することです。このファイルは、フォームフィールドを含む DOCX ドキュメントである必要があります。

string inputFilePath = Constants.SampleLegacyFormFields_docx;

ステップ2: ファイルパスからストリームを作成する

次に、入力ドキュメントを読み取るためのファイルストリームを作成します。これにより、ドキュメントをエディターに読み込むことができます。

using (FileStream fs = File.OpenRead(inputFilePath))

ステップ3: ドキュメントの読み込みオプションを作成する

この手順では、ドキュメントの読み込みオプションを作成する必要があります。ドキュメントがパスワードで保護されている場合は、パスワードを指定できます。この例では、ドキュメントは保護されていないため、パスワードは無視されます。

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.Password = "some_password_to_open_a_document";

ステップ4: ドキュメントをエディターインスタンスに読み込む

次に、指定されたオプションを含むドキュメントを Editor インスタンスに読み込みます。ここでドキュメントの主な操作が行われます。

using (Editor editor = new Editor(delegate { return fs; }, delegate { return loadOptions; }))

ステップ 4.1: FormFieldManager インスタンスの読み取り

のFormFieldManagerインスタンスは、ドキュメント内のフォームフィールドの管理を担当します。フォームフィールドにアクセスして操作するには、このインスタンスを読み取る必要があります。

FormFieldManager fieldManager = editor.FormFieldManager;

ステップ 4.2: FormFieldCollection の読み取り

のFormFieldCollectionドキュメント内のすべてのフォームフィールドが含まれます。このコレクションを読み取って、無効なフォームフィールドをチェックし、修正します。

FormFieldCollection collection = fieldManager.FormFieldCollection;

ステップ 4.3: 無効なフォームフィールドを自動修正する

ドキュメント内の無効なフォームフィールドを自動修正します。これは明らかな問題に対処するための予備的な手順です。

fieldManager.FixInvalidFormFieldNames(new InvalidFormField[0]);
collection = fieldManager.FormFieldCollection;

ステップ4.4: 無効なフォームフィールドを確認する

自動修正の試行後に無効なフォームフィールドが残っているかどうかを確認します。

bool hasInvalidFormFields = fieldManager.HasInvalidFormFields();
Console.WriteLine("FormFieldCollection contains invalid items: {0}", hasInvalidFormFields);

ステップ 4.4.1: 無効なフォームフィールド名をすべて取得する

すべての無効なフォームフィールドの名前を取得します。これらの名前はフィールドを修正するために使用されます。

var invalidFormFields = fieldManager.GetInvalidFormFieldNames();

ステップ4.4.2: 無効なフィールドに一意の名前を作成する

無効なフォームフィールドごとに一意の名前を作成します。これにより、既存のフォームフィールド名との競合がなくなります。

foreach (var invalidItem in invalidFormFields)
{
    invalidItem.FixedName = string.Format("{0}_{1}", invalidItem.Name, Guid.NewGuid());
}

ステップ4.4.3: 無効なフォームフィールドを修正する

前の手順で作成した一意の名前を使用して、無効なフォームフィールドを修正します。

fieldManager.FixInvalidFormFieldNames(invalidFormFields);
collection = fieldManager.FormFieldCollection;

ステップ5: ドキュメント保存オプションを作成する

ドキュメントを保存するためのオプションを設定します。これには、形式の指定や追加の保存設定が含まれます。

WordProcessingFormats docFormat = WordProcessingFormats.Docx;
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);

ステップ5.1: メモリ使用量を最適化する

文書が大きく、OutOfMemoryExceptionメモリ最適化オプションを有効にします。

saveOptions.OptimizeMemoryUsage = true;

ステップ5.2: 文書への書き込みを防止する

フォームフィールドを除いてドキュメントが変更されないように保護するには、保護パスワードを設定します。

saveOptions.Protection = new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password");

ステップ6: ドキュメントを保存する

最後に、指定された保存オプションでドキュメントを保存します。出力ドキュメントを保存するためのメモリストリームを準備します。

using (MemoryStream outputStream = new MemoryStream())
{
    editor.Save(outputStream, saveOptions);
}
Console.WriteLine("FixInvalidFormFieldCollectionAndSave routine has successfully finished");

結論

これで完了です。Groupdocs.Editor for .NET を使用して無効なフォームフィールドを修正し、ドキュメントを保存できました。このステップバイステップのガイドにより、プロセスが明確になり、管理しやすくなりました。問題が発生したり、質問がある場合は、ドキュメンテーションまたは連絡するサポート.

よくある質問

ドキュメントがパスワードで保護されている場合はどうなりますか?

パスワードはWordProcessingLoadOptionsドキュメントを開きます。

無効なフォームフィールドがあるかどうかはどうすればわかりますか?

使用HasInvalidFormFieldsドキュメント内の無効なフォームフィールドをチェックするメソッド。

名前を変更せずにフォームフィールドを修正できますか?

競合を避けるために、無効なフォームフィールドに一意の名前を作成することをお勧めします。

どのような形式でドキュメントを保存できますか?

適切な設定を行うことで、DOCX、PDFなどのさまざまな形式で文書を保存できます。WordProcessingFormats.

大きなドキュメントを保存するときにメモリ使用量を最適化するにはどうすればよいですか?

有効にするOptimizeMemoryUsageオプションのWordProcessingSaveOptions大きな文書を効率的に処理します。