StorePermissionAttribute.Flags プロパティ

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

StorePermissionAttribute.Flags プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ストアのアクセス許可を取得または設定します。

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

Visual Basic (宣言)

Public Property Flags As
 StorePermissionFlags

Visual Basic (使用法)

Dim instance As StorePermissionAttribute
Dim value As StorePermissionFlags

value = instance.Flags

instance.Flags = value

C#

public StorePermissionFlags Flags { get; set;
 }

C++

public:
property StorePermissionFlags Flags {
    StorePermissionFlags get ();
    void set (StorePermissionFlags value);
}

J#

/** @property */
public StorePermissionFlags get_Flags ()

/** @property */
public void set_Flags (StorePermissionFlags
 value)

JScript

public function get Flags
 () : StorePermissionFlags

public function set Flags
 (value : StorePermissionFlags)

プロパティ値
StorePermissionFlags 値のビットごとの組み合わせ。既定値は NoFlags です。

解説

注意
これらのフラグの多くは強力であり、ストアへのアクセスを許可するので、信頼性の高いコードだけに付与するようにしてください。

最も強力なフラグは、AddToStore、CreateStore、DeleteStore、および AllFlags です。これらのフラグの使用により発生する具体的な危険性については、各フラグの説明を参照してください。

使用例

Flags プロパティを使用して、ストアに追加するためのアクセス許可を拒否するコード例を次に示します。このコード例は、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 名前空間