StorePermissionAttribute

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

StorePermissionAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class
 Or AttributeTargets.Struct Or AttributeTargets.Constructor
 Or AttributeTargets.Method, AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class
 StorePermissionAttribute
    Inherits CodeAccessSecurityAttribute

Visual Basic (使用法)

Dim instance As StorePermissionAttribute

C#

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false)] 
public sealed class StorePermissionAttribute
 : CodeAccessSecurityAttribute

C++

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets::Assembly|AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Constructor|AttributeTargets::Method,
 AllowMultiple=true, Inherited=false)] 
public ref class StorePermissionAttribute sealed
 : public CodeAccessSecurityAttribute

J#

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

JScript

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Assembly|AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method,
 AllowMultiple=true, Inherited=false) 
public final class StorePermissionAttribute
 extends CodeAccessSecurityAttribute

解説

宣言の許容スコープは、使用する SecurityAction 値によって異なります。

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

使用例

StorePermissionAttribute を使用して、ストアに追加するためのアクセス許可を拒否するコード例を次に示します。このコード例は、StorePermission クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

'Deny the permission the ability to add to a store.
<StorePermission(SecurityAction.Deny, Flags:=StorePermissionFlags.AddToStore)>
 _
Private Shared Sub AddToStore(ByVal
 cert As X509Certificate2)
    Try
        Dim store As New
 X509Store("teststore", StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadWrite)
        ' The following attempt to add a certificate results in an exception
 being thrown.
        store.Add(cert)
        Return
    Catch e As SecurityException
        Console.WriteLine("Security exception thrown when attempting:
 " + _
        CType(e.FirstPermissionThatFailed, System.Security.Permissions.StorePermission).Flags)
        Return
    End Try

End Sub 'AddToStore

C#

//Deny the permission the ability to add to a store.
[StorePermission(SecurityAction.Deny, Flags = StorePermissionFlags.AddToStore)]
private static void AddToStore(X509Certificate2
 cert)
{
    try
    {
        X509Store store = new X509Store("teststore"
,
 StoreLocation.CurrentUser);

        store.Open(OpenFlags.ReadWrite);

        // The following attempt to add a certificate results in an
 exception being thrown.
        store.Add(cert);
        return;
    }
    catch (SecurityException e)
    {
        Console.WriteLine("Security exception thrown when attempting: "
 + 
            ((StorePermission)e.FirstPermissionThatFailed).Flags);
        return;
    }
}

J#

//Deny the permission the ability to add to a store.
/** @attribute StorePermission(SecurityAction.Deny, Flags =
    StorePermissionFlags.AddToStore)
 */
private static void AddToStore(X509Certificate2
 cert)
{
    try
    {
        X509Store store = new X509Store("teststore"
,
            StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadWrite);
        // The following attempt to add a certificate results in 
        // an exception being thrown.
        store.Add(cert);
        return;
    }
    catch (System.Security.SecurityException e)
    {
        Console.WriteLine("Security exception thrown when attempting: "
            + ((StorePermission)e.get_FirstPermissionThatFailed()).get_Flags());
        return;
    }
} //AddToStore

継承階層

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

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
StorePermissionAttribute メンバ
System.Security.Permissions 名前空間
StorePermission クラス
StorePermissionFlags
その他の技術情報
属性を使用したメタデータの拡張

StorePermissionAttribute コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したセキュリティ アクションを使用して StorePermissionAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    action As SecurityAction _
)

Visual Basic (使用法)

Dim action As SecurityAction

Dim instance As New StorePermissionAttribute(action)

C#

public StorePermissionAttribute (
    SecurityAction action
)

C++

public:
StorePermissionAttribute (
    SecurityAction action
)

J#

public StorePermissionAttribute (
    SecurityAction action
)

JScript

public function StorePermissionAttribute (
    action : SecurityAction
)

パラメータ

action

SecurityAction 値の 1 つ。

使用例

StorePermissionAttribute を使用して、ストアに追加するためのアクセス許可を拒否するコード例を次に示します。このコード例は、StorePermission クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

'Deny the permission the ability to add to a store.
<StorePermission(SecurityAction.Deny, Flags:=StorePermissionFlags.AddToStore)>
 _
Private Shared Sub AddToStore(ByVal
 cert As X509Certificate2)
    Try
        Dim store As New
 X509Store("teststore", StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadWrite)
        ' The following attempt to add a certificate results in an exception
 being thrown.
        store.Add(cert)
        Return
    Catch e As SecurityException
        Console.WriteLine("Security exception thrown when attempting:
 " + _
        CType(e.FirstPermissionThatFailed, System.Security.Permissions.StorePermission).Flags)
        Return
    End Try

End Sub 'AddToStore

C#

//Deny the permission the ability to add to a store.
[StorePermission(SecurityAction.Deny, Flags = StorePermissionFlags.AddToStore)]
private static void AddToStore(X509Certificate2
 cert)
{
    try
    {
        X509Store store = new X509Store("teststore"
,
 StoreLocation.CurrentUser);

        store.Open(OpenFlags.ReadWrite);

        // The following attempt to add a certificate results in an
 exception being thrown.
        store.Add(cert);
        return;
    }
    catch (SecurityException e)
    {
        Console.WriteLine("Security exception thrown when attempting: "
 + 
            ((StorePermission)e.FirstPermissionThatFailed).Flags);
        return;
    }
}

J#

//Deny the permission the ability to add to a store.
/** @attribute StorePermission(SecurityAction.Deny, Flags =
    StorePermissionFlags.AddToStore)
 */
private static void AddToStore(X509Certificate2
 cert)
{
    try
    {
        X509Store store = new X509Store("teststore"
,
            StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadWrite);
        // The following attempt to add a certificate results in 
        // an exception being thrown.
        store.Add(cert);
        return;
    }
    catch (System.Security.SecurityException e)
    {
        Console.WriteLine("Security exception thrown when attempting: "
            + ((StorePermission)e.get_FirstPermissionThatFailed()).get_Flags());
        return;
    }
} //AddToStore

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
StorePermissionAttribute クラス
StorePermissionAttribute メンバ
System.Security.Permissions 名前空間

StorePermissionAttribute プロパティ

パブリック プロパティ

	名前	説明
	Action	セキュリティ アクションを取得または設定します。 ( SecurityAttribute から継承されます。)
	AddToStore	コードでストアへの追加が許可されているかどうかを示す値を取得または設定します。
	CreateStore	コードでストアの作成が許可されているかどうかを示す値を取得または設定します。
	DeleteStore	コードでストアの削除が許可されているかどうかを示す値を取得または設定します。
	EnumerateCertificates	コードでストア内の証明書の列挙が許可されているかどうかを示す値を取得または設定します。
	EnumerateStores	コードでストアの列挙が許可されているかどうかを示す値を取得または設定します。
	Flags	ストアのアクセス許可を取得または設定します。
	OpenStore	コードでストアを開くことが許可されているかどうかを示す値を取得または設定します。
	RemoveFromStore	コードでストア内の証明書の削除が許可されているかどうかを示す値を取得または設定します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
	Unrestricted	属性によって保護されているリソースに対して完全な (無制限の) アクセス許可が宣言されているかどうかを示す値を取得または設定します。 ( SecurityAttribute から継承されます。)

参照

関連項目

StorePermissionAttribute クラス
System.Security.Permissions 名前空間
StorePermission クラス
StorePermissionFlags

その他の技術情報

属性を使用したメタデータの拡張

StorePermissionAttribute メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreatePermission	オーバーライドされます。 新しい StorePermission を作成して返します。
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

StorePermissionAttribute クラス
System.Security.Permissions 名前空間
StorePermission クラス
StorePermissionFlags

その他の技術情報

属性を使用したメタデータの拡張

StorePermissionAttribute メンバ

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

StorePermissionAttribute データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	StorePermissionAttribute	指定したセキュリティ アクションを使用して StorePermissionAttribute クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Action	セキュリティ アクションを取得または設定します。(SecurityAttribute から継承されます。)
	AddToStore	コードでストアへの追加が許可されているかどうかを示す値を取得または設定します。
	CreateStore	コードでストアの作成が許可されているかどうかを示す値を取得または設定します。
	DeleteStore	コードでストアの削除が許可されているかどうかを示す値を取得または設定します。
	EnumerateCertificates	コードでストア内の証明書の列挙が許可されているかどうかを示す値を取得または設定します。
	EnumerateStores	コードでストアの列挙が許可されているかどうかを示す値を取得または設定します。
	Flags	ストアのアクセス許可を取得または設定します。
	OpenStore	コードでストアを開くことが許可されているかどうかを示す値を取得または設定します。
	RemoveFromStore	コードでストア内の証明書の削除が許可されているかどうかを示す値を取得または設定します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
	Unrestricted	属性によって保護されているリソースに対して完全な (無制限の) アクセス許可が宣言されているかどうかを示す値を取得または設定します。(SecurityAttribute から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreatePermission	オーバーライドされます。 新しい StorePermission を作成して返します。
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

StorePermissionAttribute クラス
System.Security.Permissions 名前空間
StorePermission クラス
StorePermissionFlags

その他の技術情報

属性を使用したメタデータの拡張