インサートフィールド

フィールドをドキュメントにインサートする方法はいくつかあります。

この記事では、これらのオプションを使用して、特定のフィールドをインサートする方法を詳細に分析します。

DocumentBuilder を使用してフィールドを文書化

インスタグラム Aspose.Words お問い合わせ InsertField メソッドは新しいフィールドをドキュメントに差し込むために使用されます。 最初のパラメータは、フィールドの完全なフィールドコードを差し込みます。 2番目のパラメータはオプションで、フィールドのフィールド結果が手動で設定できます。 これが供給されていない場合、フィールドは自動的に更新されます。 このパラメータに null または empty を渡して、フィールドを空のフィールド値で入力できます。 特定のフィールドコードの構文がわからない場合は、フィールドをフィールドに作成します。 Microsoft Word フィールドコードを最初に表示し、フィールドコードを表示するように切り替えます。

次のコードの例では、マージフィールドをドキュメントにインサートする方法を示します。 DocumentBuilder:::

他のフィールドにネストされたフィールドをインサートするために同じ技術を使用します。

次のコード例では、別のフィールド内でネストされたフィールドを別のフィールドに挿す方法を示します。 DocumentBuilder:::

フィールドレベルにロケールを指定する

言語識別子は、国や地域における言語の標準的な国際数値の略語です。 と Aspose.Words, フィールドレベルの Locale を指定できます。 LocaleId フィールドの locale ID を取得またはセットするプロパティ。

次のコードの例では、このオプションを使用する方法を示します。

インサート 未入力/空のフィールド

untyped/empty フィールドをインサートしたい場合 (){}) いいね Microsoft Word 許可して下さい、使用することができます InsertField メソッドとメソッド FieldType.FieldNone パラメータ。 フィールドをWord文書に入力するには、「Ctrl + F9」キーコンビネーションを押します。

次のコードの例では、空のフィールドをドキュメントに差し込む方法を示します。

インサート COMPARE フィールド

ザ・オブ・ザ・ COMPARE フィールドは2つの値を比較し、比較がない場合の数値1を返します。 true 比較がない場合、または0 falseお問い合わせ

次のコードの例では、追加する方法を示します。 COMPARE DocumentBuilder を使用したフィールド:

インサート IF フィールド

ザ・オブ・ザ・ IF フィールドは、条件付きで引数を評価するために使用できます。

次のコードの例では、追加する方法を示します。 IF DocumentBuilder を使用したフィールド:

フィールドビルダーを使用して文書にフィールドをインサートする

フィールドをインサートする代替方法 Aspose.Words です。 FieldBuilder クラス。 フィールド スイッチと引数の値をテキスト、ノード、またはネストされたフィールドとして指定するインフルエント インターフェイスを提供します。

次のコードの例では、フィールドをドキュメントに書き込む方法を示します。 FieldBuilder:::

インサートフィールドの使用 DOM

また、さまざまなフィールドの入力も可能です。 Aspose.Words Document Object Model (DOM)お問い合わせ このセクションでは、いくつかの例を見てみましょう。

インサートマージ ドキュメントへのフィールド DOM

MERGEFIELD Word文書のフィールドは、 FieldMergeField クラス。 使える FieldMergeField 次の操作を実行するクラス:

  • merge フィールドの名前を指定します
  • merge フィールドの書式を指定する
  • フィールドセパレータとマージフィールドのフィールド終了の間のテキストを指定します
  • フィールドが空白でないとマージフィールドの後に入力するテキストを指定します
  • フィールドが空白でないとマージフィールドの前に入力するテキストを指定します

次のコードの例では、追加する方法を示します。 MERGE フィールド使用 DOM 文書の段落に:

インサート Mail Merge ADDRESSBLOCK ドキュメントへのフィールド DOM

ザ・オブ・ザ・ ADDRESSBLOCK フィールドをインサートするために使用されます mail merge ワード文書のアドレスブロック。 ADDRESSBLOCK Word文書のフィールドは、 FieldAddressBlock クラス。 使える FieldAddressBlock 次の操作を実行するクラス:

  • フィールドに国/地域の名前を含めるかどうかを指定する
  • POST*CODE(Universal Postal Union 2006)で定義された受取人の国/地域に応じてアドレスをフォーマットするかどうかを指定します。
  • 除外国/地域名を指定する
  • 名前とアドレスの形式を指定します
  • アドレスをフォーマットするために使用される言語 ID を指定します

次のコードの例では、追加する方法を示します。 Mail Merge ADDRESSBLOCK フィールド使用 DOM 文書の段落に:

インサート ADVANCE DocumentBuilder を使用せずにドキュメントにフィールド

ザ・オブ・ザ・ ADVANCE フィールドは、行の後に続くテキストを左、右、上、下へオフセットするために使用されます。 ADVANCE Word文書のフィールドは、 FieldAdvance クラス。 使うことができます。 FieldAdvance 次の操作を実行するクラス:

  • フィールドに続くテキストがページ上部の端から縦に動かされるべきポイントの数を指定します
  • フィールドに続くテキストが列、フレーム、またはテキストボックスの左端から水平に移動されるべきポイントの数を指定します
  • フィールドに続くテキストが左、右、上、下に移動すべき点数を指定します。

次のコードの例では、追加する方法を示します。 ADVANCE フィールド使用 DOM 文書の段落に:

インサート ASK DocumentBuilder を使用せずにドキュメントにフィールド

ザ・オブ・ザ・ ASK フィールドは、Word文書のブックマークに割り当てるテキストのユーザを促すために使用されます。 ASK Word文書のフィールドは、 FieldAsk クラス。 使える FieldAsk 次の操作を実行するクラス:

  • ブックマークの名前を指定します
  • デフォルトユーザ応答(プロンプトウィンドウに含まれている初期値)を指定する
  • ユーザ応答が1回受信されるかどうかを指定します mail merge オペレーション
  • プロンプトテキスト(プロンプトウィンドウのタイトル)を指定する

次のコードの例では、追加する方法を示します。 ASK フィールド使用 DOM 文書の段落に:

インサート AUTHOR DocumentBuilder を使用せずにドキュメントにフィールド

ザ・オブ・ザ・ AUTHOR フィールドは、ドキュメントの作者の名前を から指定するために使用されます。 Document プロパティ。 AUTHOR Word文書のフィールドは、 FieldAuthor クラス。 使える FieldAuthor 次の操作を実行するクラス:

  • 文書の作者の名前を指定する

次のコードの例では、追加する方法を示します。 AUTHOR フィールド使用 DOM 文書の段落に:

インサート INCLUDETEXT DocumentBuilder を使用せずにドキュメントにフィールド

ザ・オブ・ザ・ INCLUDETEXT フィールドはフィールドコードに含まれる文書に含まれるテキストとグラフィックをインサートします。 ドキュメント全体またはブックマークで参照するドキュメントの一部を入力できます。 ワード文書のこのフィールドはINCLUDETEXTで表されます。 使える FieldIncludeText 次の操作を実行するクラス:

  • 含まれている文書のブックマークの名前を指定します
  • ドキュメントの場所を指定する

次のコードの例では、追加する方法を示します。 INCLUDETEXT フィールド使用 DOM 文書の段落に:

インサート TOA DocumentBuilder を使用せずにドキュメントにフィールド

ザ・オブ・ザ・ TOA (Authorities の可) フィールドビルドと権限の表をインサートします。 ザ・オブ・ザ・ TOA フィールドは、マークされたエントリを収集します TA (権限エントリーの可) Microsoft オフィスワードは、 TOA フィールドをクリックすると、AuthoritiesのInsert Tableをクリックします。 著者の表 グループ References タブ。 閲覧するとき TOA ドキュメントのフィールド、構文はこのようになります。

{ TOA [Switches ] }

次のコードの例では、追加する方法を示します。 TOA フィールド使用 DOM 文書の段落に。