フィールドプロパティのカスタマイズ

Aspose.Words は、さまざまなフィールド プロパティをプログラムで操作する機能を提供します。この記事では、フィールド プロパティの操作の基本原則を理解できるように、いくつかの例を見ていきます。 フィールドの名前空間 内の対応するクラスの各フィールド タイプのプロパティの完全なリストを確認できます。

フィールドプロパティの更新

場合によっては、ユーザーはフィールド プロパティの値を変更する必要があります。たとえば、AUTHOR フィールドの AuthorName プロパティを更新するか、MERGEFIELD フィールドの FieldName プロパティを変更します。

次のコード例は、Word 文書内の差し込みフィールドの名前を変更する方法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertField(@"MERGEFIELD MyMergeField1 \* MERGEFORMAT");
builder.InsertField(@"MERGEFIELD MyMergeField2 \* MERGEFORMAT");

foreach (FieldMergeField mergeField in doc.Range.Fields.OfType<FieldMergeField>().ToList())
    mergeField.FieldName = mergeField.FieldName + "_Renamed";

doc.Save(ArtifactsDir + "WorkingWithFields.RenameMergeFields.docx");

フィールド表示結果

Aspose.Words は、フィールド区切りノードを持たないフィールドのフィールドの結果を取得するプロパティを提供します。これを「偽の結果」または表示結果と呼びます。 MS Word はフィールドの値をオンザフライで計算することによって文書内に表示しますが、文書モデルにはそのような値はありません。

次のコード例は、DisplayResult プロパティの使用法を示しています。

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Various fields.docx");

doc.UpdateFields();

foreach (Field field in doc.Range.Fields)
    Console.WriteLine(field.DisplayResult);