EnvironmentPermission.AddPathList メソッド

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

EnvironmentPermission.AddPathList メソッド

アクセス許可の既存の状態に、指定した環境変数へのアクセス権を追加します。

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

Visual Basic (宣言)

Public Sub AddPathList ( _
    flag As EnvironmentPermissionAccess, _
    pathList As String _
)

Visual Basic (使用法)

Dim instance As EnvironmentPermission
Dim flag As EnvironmentPermissionAccess
Dim pathList As String

instance.AddPathList(flag, pathList)

C#

public void AddPathList (
    EnvironmentPermissionAccess flag,
    string pathList
)

C++

public:
void AddPathList (
    EnvironmentPermissionAccess flag, 
    String^ pathList
)

J#

public void AddPathList (
    EnvironmentPermissionAccess flag, 
    String pathList
)

JScript

public function AddPathList (
    flag : EnvironmentPermissionAccess, 
    pathList : String
)

パラメータ

flag

EnvironmentPermissionAccess 値の 1 つ。

pathList

環境変数の (セミコロン区切りの) リスト。

例外

例外の種類	条件
ArgumentNullException	pathList パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentException	flag パラメータが、EnvironmentPermissionAccess の有効値ではありません。

解説

このメソッドを使用して、現在のアクセス許可の状態に環境変数へのアクセスを追加することによって、その環境変数へのアクセスを変更します。

使用例

AddPathList メソッドを使用するコード例を次に示します。このコード例は、EnvironmentPermission クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Private Function SetGetPathListDemo() As
 Boolean 
    Try
        Console.WriteLine("********************************************************"
 + vbLf)
        Console.WriteLine("Creating an EnvironmentPermission with
 AllAccess rights for 'TMP'")
        Dim envPerm1 As New
 EnvironmentPermission(EnvironmentPermissionAccess.AllAccess, "TMP")
        Console.WriteLine("Adding 'TEMP' to the write access list,
 and 'windir' to the read access list.")
        envPerm1.AddPathList(EnvironmentPermissionAccess.Write, "TEMP")
        envPerm1.AddPathList(EnvironmentPermissionAccess.Read, "windir")
        Console.WriteLine("Read access list before SetPathList
 = " + envPerm1.GetPathList(EnvironmentPermissionAccess.Read))
        Console.WriteLine("Setting read access to 'TMP'")
        envPerm1.SetPathList(EnvironmentPermissionAccess.Read, "TMP")
        Console.WriteLine("Read access list after SetPathList
 = " + envPerm1.GetPathList(EnvironmentPermissionAccess.Read))
        Console.WriteLine("Write access list = " +
 envPerm1.GetPathList(EnvironmentPermissionAccess.Write))
        Console.WriteLine("Write access environment variables
 = " + envPerm1.GetPathList(EnvironmentPermissionAccess.AllAccess))
    Catch e As ArgumentException
        ' EnvironmentPermissionAccess.AllAccess cannot be used as a
 parameter for GetPathList.
        Console.WriteLine("An ArgumentException occurred as a
 result of using AllAccess. " + _
        " This property cannot be used as a parameter in GetPathList,
 because it represents " + _
        "more than one type of environment variable : "
 + vbLf + e.Message)
    End Try
    
    Return True

End Function 'SetGetPathListDemo

C#

private bool SetGetPathListDemo()
{
    try
    {
        Console.WriteLine("********************************************************\n");
        Console.WriteLine("Creating an EnvironmentPermission with AllAccess
 rights for 'TMP'");
        EnvironmentPermission envPerm1 = new EnvironmentPermission(EnvironmentPermissionAccess.AllAccess,
 "TMP");
        Console.WriteLine("Adding 'TEMP' to the write access list, and 'windir'
 to the read access list.");
        envPerm1.AddPathList(EnvironmentPermissionAccess.Write, "TEMP");
        envPerm1.AddPathList(EnvironmentPermissionAccess.Read, "windir");
        Console.WriteLine("Read access list before SetPathList = "
            + envPerm1.GetPathList(EnvironmentPermissionAccess.Read));
        Console.WriteLine("Setting read access to 'TMP'");
        envPerm1.SetPathList(EnvironmentPermissionAccess.Read, "TMP");
        Console.WriteLine("Read access list after SetPathList = "
            + envPerm1.GetPathList(EnvironmentPermissionAccess.Read));
        Console.WriteLine("Write access list = " + envPerm1.GetPathList(EnvironmentPermissionAccess.Write));
        Console.WriteLine("Write access environment variables = "
            + envPerm1.GetPathList(EnvironmentPermissionAccess.AllAccess));
    }
    catch (ArgumentException e)
    {
        // EnvironmentPermissionAccess.AllAccess cannot be used as a
 parameter for GetPathList.
        Console.WriteLine("An ArgumentException occurred as a result of using
 AllAccess. "
            + " This property cannot be used as a parameter in
 GetPathList, because it represents "
            + "more than one type of environment variable : \n" + e);
    }

    return true;
}

プラットフォーム

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

参照

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