ユーザー情報

ユーザー情報

このガイドでは、Aspose.Words FOSS for .NET がユーザー関連ドキュメントフィールドを通じて報告する現在のユーザー識別子を設定する方法を示します。

UserInformation は、.NET 用の FOSS が「現在のユーザー」を報告するフィールド（Name、Initials、Address）を評価する際に使用する識別子を表します。これは FieldOptions.CurrentUser を通じてドキュメントのフィールド評価設定に付与され、UserInformation.DefaultUser を通じてプロセス全体のフォールバックが利用可能です。

現在のユーザーの設定

Document.FieldOptions（FieldOptions のインスタンス）は、UserInformation オブジェクトである CurrentUser を公開します。ユーザー情報フィールドを更新する前に、その Name、Initials、Address プロパティを設定し、報告される値がアプリケーションが記録したい識別子と一致するようにします。UserInformation.DefaultUser は、ドキュメントの FieldOptions.CurrentUser が明示的に設定されていない場合に使用できる、静的なプロセス全体の UserInformation インスタンスを提供します。

ユーザー情報フィールド

3 つの Field サブクラスが現在のユーザーの識別子をドキュメント本文に読み込みます: FieldUserName（USERNAME フィールド、UserName プロパティ付き）、FieldUserAddress（USERADDRESS フィールド、UserAddress プロパティ付き）、および FieldUserInitials（USERINITIALS フィールド、UserInitials プロパティ付き）。他のフィールドと同様に、これらは基本的な Field ライフサイクル — GetFieldCode()、Result、Update()、Unlink()、Remove() — を共有し、DocumentBuilder.InsertField(fieldCode) または InsertField(fieldType, updateField) で挿入でき、FieldType.FieldUserName、FieldType.FieldUserAddress、または FieldType.FieldUserInitials を使用します。

ヒントとベストプラクティス

• FieldOptions.CurrentUser を設定してから、FieldUserName、FieldUserAddress、または FieldUserInitials フィールドで Update() を呼び出すか、Document.UpdateFields() の前に設定してください — そうしないと、フィールドは現在有効な UserInformation に対して解決されます。
• UserInformation.DefaultUser は、アプリケーションが処理するすべてのドキュメントで同じ ID が適用される場合の便利な共有デフォルトです。異なるドキュメントに異なる作者が必要な場合は、FieldOptions.CurrentUser をドキュメントごとに設定してください。
• テンプレートが FieldUserName、FieldUserAddress、FieldUserInitials のうち複数を使用する場合は、Name、Initials、Address の 3 つをすべて同時に設定してください — 1 つだけ空白にするとエラーではなく空のフィールド結果が生成されます。

一般的な問題

FAQ

FieldOptions.CurrentUser と UserInformation.DefaultUser の違いは何ですか？

FieldOptions.CurrentUser はドキュメント単位です — 特定の Document の FieldOptions に設定して、そのドキュメントのユーザー情報フィールドを制御します。UserInformation.DefaultUser は静的なプロセス全体のフォールバックです。

UserInformation はどのフィールドに影響しますか？

FieldUserName（USERNAME）、FieldUserAddress（USERADDRESS）、および FieldUserInitials（USERINITIALS）— それぞれアクティブな UserInformation から対応する Name、Address、または Initials プロパティを読み取ります。

UserInformation を変更した後、Update() を呼び出す必要がありますか？

はい — Name、Initials、または Address を変更しても、ドキュメント内ですでに評価されたフィールドは遡って更新されません。特定のフィールドに対しては Update() を呼び出すか、Document.UpdateFields() を使用してください。

API Reference の概要

参照

• Aspose.Words for .NET — Enterprise Documentation