.NET で遷移フィールドを使用する方法

ステップ 1: ドキュメント内のトランジショナル フィールドを見つける

Document.Range.Fields を列挙し、各フィールドの Type（FieldType 値）を該当する定数 — FieldBarcode、FieldDisplayBarcode、FieldMergeBarcode、FieldBidiOutline、FieldEQ、FieldFootnoteRef、または FieldInfo — と比較します。その後、汎用 Field を対応するクラスにキャストして固有のプロパティにアクセスします。キャストする前に必ず Type を確認してください。誤ったフィールド クラスにキャストすると InvalidCastException がスローされます。

ステップ 2: DISPLAYBARCODE または MERGEBARCODE フィールドを設定する

FieldDisplayBarcode（DISPLAYBARCODE フィールド）と FieldMergeBarcode（MERGEBARCODE フィールド、メールマージ用の IMergeFieldSurrogate も実装しています）は、同じバーコード構成プロパティのセットを共有します：BarcodeType、BarcodeValue、SymbolHeight、SymbolRotation、ScalingFactor、ForegroundColor、BackgroundColor、PosCodeStyle、CaseCodeStyle、ErrorCorrectionLevel、DisplayText、AddStartStopChar、および FixCheckDigit。フィールドインスタンスにこれらを設定し、Update() を呼び出して、ドキュメントを保存する前に Result が新しい構成を反映するようにします。

ステップ 3: レガシー BARCODE（郵便）フィールドデータを読み取る

FieldBarcode は、一般的なバーコードではなく、米国郵便バーコード（POSTNET）フィールドである古い BARCODE フィールドを実装しています — Step 2 の BarcodeType/BarcodeValue プロパティは共有しません。その代わり、PostalAddress（バーコードがエンコードする住所）、FacingIdentificationMark、IsUSPostalAddress、および IsBookmark を公開します。これらのプロパティを読み取る前に、Field.Type を FieldType.FieldBarcode と特に比較してください。DISPLAYBARCODE または MERGEBARCODE フィールドを FieldBarcode にキャストすると、期待するプロパティが公開されないためです。

ステップ 4: カスタムジェネレータでバーコード画像をレンダリングする

この FOSS エディションはバーコードフィールドデータを保持していますが、バーコードレンダリングエンジンは含まれていません。BarcodeParameters は、バーコードフィールドファミリーのいずれか（Step 2 の DISPLAYBARCODE/MERGEBARCODE プロパティと Step 3 の郵便プロパティ）から設定を統合し、レンダラに渡される単一のオブジェクトにまとめるパススルーコンテナです。IBarcodeGenerator を実装し、GetBarcodeImage(parameters) とレガシーの GetOldBarcodeImage(parameters) を公開して実際の画像レンダリングを提供してください。実装が提供されない場合、バーコードフィールドは構成データのみを保持します。

ステップ 5: レガシー互換フィールドを扱う

レガシー .docx ファイルにまだ存在する古いフィールドコードをカバーするクラスが他に4つあります。FieldBidiOutline は、右から左へのアウトライン番号付け用の BIDIOUTLINE フィールドを実装しており、共通の Field 表面以外にプロパティは公開しません。FieldEQ は EQ 方程式フィールドを実装し、さらにその内容を OfficeMath オブジェクトに変換するための AsOfficeMath() を公開します—これはフィールドが実際に方程式をエンコードしている場合にのみ成功します。FieldFootnoteRef は脚注または文末注のマークを相互参照する FOOTNOTEREF フィールドを実装しており、共通の Field 表面以外にプロパティは公開しません。FieldInfo は INFO フィールドを実装し、その InfoType および NewValue プロパティを通じてドキュメントのサマリー情報プロパティの読み書きを行います。

ステップ 6: 移行フィールドの値を更新または固定する

すべての遷移フィールドクラスは GetFieldCode()（フィールドの基礎となるコードテキスト）、Update()（結果を再評価する）、Unlink()（フィールドを最後に計算された結果の静的テキストに置き換える）、および Remove()（フィールドを削除する）を継承します。フィールドの設定を変更した後は Update() を呼び出して Result が変更を反映するようにし、フィールドの現在の値を再計算可能にせず固定したい場合は Unlink() を使用します。