Permission クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フォームに UserPermissionCollection 適用できる および アクセス許可の設定へのアクセスを提供します。
public ref class Permission abstract
public abstract class Permission
type Permission = class
Public MustInherit Class Permission
- 継承
-
Permission
注釈
アクティブなフォームへのアクセス許可を制限し、特定のアクセス許可の設定を取得または指定するには、Permission クラスおよびそのメンバーを使用します。
フォーム テンプレートに関連付けられている Permission クラスのインスタンスは、 クラスの XmlForm プロパティによってMicrosoft.Office.InfoPath.Xmlform.Permission返されます。 返された Permission オブジェクトは、フォーム テンプレートに関連付けられているオブジェクトの UserPermission コレクションと、そのテンプレートで作成された各フォーム インスタンスへのアクセスを提供します。 各 UserPermission オブジェクトは、個別のユーザーのアクセス許可のセットを定義するために使用します。 ユーザー インターフェイスを通じて付与される一部のアクセス許可はすべてのユーザーに適用されますが、UserPermission オブジェクトを使用すると、ユーザーおよびその有効期限日ごとにアクセス許可を割り当てることができます。
Permission オブジェクトおよびそのプロパティとメソッドは、アクティブなフォーム テンプレートでアクセス許可が制限されているかどうかにかかわらず利用できます。 フォームに Enabled 制限付きアクセス許可があるかどうかを判断するには、 プロパティを使用します。
Windows Rights Management クライアントがユーザーのコンピューターにインストールされていない場合は、 Permission クラスを使用すると、例外が発生します。
フォームに対するアクセス許可は、 Permission クラスのプロパティとメソッドを使用して、次のいずれかの方法で有効になります。
Enabled プロパティを true に設定している。
プロパティが DocumentAuthor 設定されています。
プロパティが RequestPermissionUrl 設定されています。
プロパティは StoreLicensestrue または false に設定 されます。
メソッドが ApplyPolicy(String) 呼び出されます。
また、UserPermissionCollection クラスのいずれかのメソッドをAdd(String)使用して、フォームのユーザー権限コレクションにユーザーを追加することで、フォームに対するアクセス許可を有効にすることもできます。
注: フォームがプレビュー モードの場合、アクセス許可を適用できません。 このため、フォームがプレビューされている場合、 Permission クラスのすべてのプロパティは読み取り専用です。 プレビュー モードでは、 Enabled プロパティは常に false を返し、コードがこの設定を変更しようとすると、 System.Runtime.InteropServices.COMException が発生し、"プロパティ/メソッドはプレビュー モードでは使用できません" というエラーが返されます。 同様に、UserPermission クラスと UserPermissionCollection クラスに関連付けられているプロパティとメソッドも、プレビュー モードで使用すると、このエラー メッセージを返します。
コンストラクター
Permission() |
フォームに UserPermissionCollection 適用できる および アクセス許可の設定へのアクセスを提供します。 |
プロパティ
DocumentAuthor |
現在のフォームの作成者を電子メール アドレス形式で取得または設定します。 |
Enabled |
Permission オブジェクトによって表されるアクセス許可設定が、現在のフォームで有効になっているかどうかを取得または設定します。 |
PermissionFromPolicy |
現在のフォームにアクセス許可ポリシーが適用されているかどうかを取得します。 |
PolicyDescription |
現在のフォームに適用されたポリシーの説明を取得します。 |
PolicyName |
現在のフォームに適用されたポリシーの名前を取得します。 |
RequestPermissionUrl |
現在のフォームで追加のアクセス許可を必要とするユーザー用に、ファイル、URL、または連絡先の電子メール アドレスを取得または設定します。 |
StoreLicenses |
現在のフォームを表示するユーザーのライセンスをキャッシュし、ユーザーがアクセス権管理サーバーに接続できないときに、オフラインの表示を許可するかどうかを取得または設定します。 |
UserPermissions |
現在のフォームの を UserPermissionCollection 取得します。 |
メソッド
ApplyPolicy(String) |
ポリシー テンプレート ファイルを使ってフォームにポリシーを適用します。 |