PrincipalPermissionAttribute クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PrincipalPermissionAttribute クラス

宣言セキュリティを使用して、PrincipalPermission のセキュリティアクションをコードに適用できるようにします。このクラスは継承できません。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Method,
 AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class
 PrincipalPermissionAttribute
    Inherits CodeAccessSecurityAttribute

Visual Basic (使用法)

Dim instance As PrincipalPermissionAttribute

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple=true,
 Inherited=false)] 
public sealed class PrincipalPermissionAttribute
 : CodeAccessSecurityAttribute

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Method, AllowMultiple=true,
 Inherited=false)] 
public ref class PrincipalPermissionAttribute
 sealed : public CodeAccessSecurityAttribute

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false) */ 
public final class PrincipalPermissionAttribute
 extends CodeAccessSecurityAttribute

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple=true,
 Inherited=false) 
public final class PrincipalPermissionAttribute
 extends CodeAccessSecurityAttribute

解説

PrincipalPermissionAttribute を使用すると、コードを実行中のユーザーが指定したロールに所属するか認証されていることを宣言によって要求できます。Unrestricted を使用すると、Authenticated が true に設定され、Name と Role が null 参照 (Visual Basic では Nothing) に設定された PrincipalPermission が作成されます。

宣言の許容スコープは、使用する SecurityAction によって異なります。PrincipalPermissionAttribute はアセンブリレベルでは適用できません。

セキュリティ属性によって宣言されたセキュリティ情報は、属性ターゲットのメタデータに格納され、実行時にシステムによってアクセスされます。セキュリティ属性は宣言セキュリティにだけ使用されます。強制セキュリティの場合は、対応するアクセス許可クラスを使用します。

重要 : プリンシパルのアクセス許可を要求する前に、現在のアプリケーションドメインのプリンシパルポリシーを列挙値 WindowsPrincipal に設定する必要があります。既定では、プリンシパルポリシーは UnauthenticatedPrincipal に設定されます。プリンシパルポリシーを WindowsPrincipal に設定しないと、プリンシパルのアクセス許可の要求は失敗します。プリンシパルのアクセス許可を要求する前に、次のコードを実行する必要があります。AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).

使用例

PrincipalPermission を宣言して使用する現在のユーザーが Bob であり、スーパバイザのロールに所属していることを要求する方法を次の例に示します。

Visual Basic

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Name := "Bob", Role := "Supervisor")>
 Public Class SampleClass

[PrincipalPermissionAttribute(SecurityAction.Demand, Name="Bob",
Role="Supervisor")]

C++

[PrincipalPermissionAttribute(SecurityAction::Demand,Name="Bob",
Role="Supervisor")]

/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand,
    Name = "Bob", Role = "Supervisor")
 */

ロールのメンバシップにかかわらず、現在のユーザーの ID が Bob であることを要求する方法を次の例に示します。

Visual Basic

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Name := "Bob")> Public Class
 SampleClass

[PrincipalPermissionAttribute(SecurityAction.Demand, Name="Bob")]

C++

[PrincipalPermissionAttribute(SecurityAction::Demand,Name="Bob")]

/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand, Name = "Bob")
 */

ユーザーが認証されていることだけを要求する方法を次の例に示します。

Visual Basic

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Authenticated := True)> Public Class
 SampleClass

[PrincipalPermissionAttribute(SecurityAction.Demand, Authenticated=true)]

C++

[PrincipalPermissionAttribute(SecurityAction::Demand,Authenticated=true)]

/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand, 
    Authenticated = true)
 */

継承階層

System.Object
   System.Attribute
     System.Security.Permissions.SecurityAttribute
       System.Security.Permissions.CodeAccessSecurityAttribute
        System.Security.Permissions.PrincipalPermissionAttribute

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。