EnvironmentPermission.GetPathList メソッドとは何？わかりやすく解説 Weblio辞書

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

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

EnvironmentPermission.GetPathList メソッド

指定した EnvironmentPermissionAccess が与えられている環境変数をすべて取得します。

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

Visual Basic (宣言)

Public Function GetPathList ( _
    flag As EnvironmentPermissionAccess _
) As String

Visual Basic (使用法)

Dim instance As EnvironmentPermission
Dim flag As EnvironmentPermissionAccess
Dim returnValue As String

returnValue = instance.GetPathList(flag)

public string GetPathList (
    EnvironmentPermissionAccess flag
)

C++

public:
String^ GetPathList (
    EnvironmentPermissionAccess flag
)

public String GetPathList (
    EnvironmentPermissionAccess flag
)

JScript

public function GetPathList (
    flag : EnvironmentPermissionAccess
) : String

パラメータ

flag: 単一の種類の環境変数アクセス許可を表す EnvironmentPermissionAccess 値の 1 つ。

戻り値
選択されたフラグの環境変数の (セミコロン区切りの) リスト。

例外

例外の種類	条件
ArgumentException	flag が有効な EnvironmentPermissionAccess 値ではありません。または flag が、複数の種類の環境変数アクセス許可を表す AllAccess か、どの種類の環境変数アクセス許可も表さない NoAccess です。

例外の種類

条件

ArgumentException

flag が有効な EnvironmentPermissionAccess 値ではありません。

または

flag が、複数の種類の環境変数アクセス許可を表す AllAccess か、どの種類の環境変数アクセス許可も表さない NoAccess です。

解説

このメソッドを使用して、現在のアクセス許可の状態を取得します。Read と Write の両方のアクセス状態を取得するには、このメソッドを 2 回呼び出す必要があります。

メモ
flag パラメータに指定できるのは、単一の種類の環境変数アクセス許可を表す EnvironmentPermissionAccess の値だけです。これらの値は、Read と Write です。NoAccess および AllAccess は、単一の種類の環境変数アクセス許可を表さないため、flag では使用できません。

使用例

GetPathList メソッドを使用するコード例を次に示します。このコード例は、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

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;
}