EnvironmentPermissionAttribute クラス

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

EnvironmentPermissionAttribute クラス

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As EnvironmentPermissionAttribute

C#

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

C++

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

J#

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

JScript

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

解説

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

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

環境変数名では、大文字と小文字は区別されません。複数の環境変数名は、PathSeparator を使用して、それぞれの名前を区切って指定します。

使用例

指定した環境変数を読み取る機能のために EnvironmentPermission を要求する正しい方法を示し、コードを実行するためには少なくともこのアクセス許可が必要であることを次の宣言属性の例に示します。

Visual Basic

<Assembly: EnvironmentPermissionAttribute(SecurityAction.RequestMinimum, _
 Read := "COMPUTERNAME;USERNAME;USERDOMAIN")>
'In Visual Basic, you must specify that you are using the assembly scope
 when making a request.

C#

[assembly:EnvironmentPermissionAttribute(SecurityAction.RequestMinimum,
Read="COMPUTERNAME;USERNAME;USERDOMAIN")]
//In C#, you must specify that you are using the assembly scope when
 making a request.

C++

[assembly:EnvironmentPermissionAttribute(SecurityAction::RequestMinimum,
Read="COMPUTERNAME;USERNAME;USERDOMAIN")];
//In C++, you must specify that you are using the assembly scope when
 making a request.

J#

/** @assembly EnvironmentPermissionAttribute(SecurityAction.RequestMinimum,
    Read = "COMPUTERNAME;USERNAME;USERDOMAIN")
 */
// In VJ#, you must specify that you are using the assembly scope when
 
// making a request.

リンク時に呼び出し元コードに EnvironmentPermission を要求する方法を次の例に示します。通常、メソッドやクラスを不正なコードから保護するための要求がマネージ ライブラリ (DLL) で作成されます。

Visual Basic

<EnvironmentPermission(SecurityAction.Demand, Unrestricted := True)>
 _
 Public Class SampleClass 

C#

[EnvironmentPermissionAttribute(SecurityAction.Demand, Unrestricted=true)]

C++

[EnvironmentPermissionAttribute(SecurityAction::Demand,Unrestricted=true)]

J#

/** @attribute EnvironmentPermissionAttribute(SecurityAction.Demand,
    Unrestricted = true)
 */

継承階層

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

スレッド セーフ

この型の 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、1.1、1.0

参照

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