EnvironmentPermission.GetPathList(EnvironmentPermissionAccess) Metoda

Definicja

Przestrzeń nazw:

System.Security.Permissions

Zestaw:

System.Security.Permissions.dll

Pakiet:

System.Security.Permissions v8.0.0

Źródło:

EnvironmentPermission.cs

Pobiera wszystkie zmienne środowiskowe z określoną wartością EnvironmentPermissionAccess.

public:
 System::String ^ GetPathList(System::Security::Permissions::EnvironmentPermissionAccess flag);

public string GetPathList (System.Security.Permissions.EnvironmentPermissionAccess flag);

member this.GetPathList : System.Security.Permissions.EnvironmentPermissionAccess -> string

Public Function GetPathList (flag As EnvironmentPermissionAccess) As String

Parametry

flag

EnvironmentPermissionAccess

EnvironmentPermissionAccess Jedna z wartości reprezentujących pojedynczy typ dostępu do zmiennej środowiskowej.

Zwraca

String

Lista zmiennych środowiskowych (rozdzielonych średnikami) dla wybranej flagi.

Wyjątki

ArgumentException

flagnie jest prawidłową wartością .EnvironmentPermissionAccess

-lub-

flag to AllAccess, który reprezentuje więcej niż jeden typ dostępu do zmiennej środowiskowej lub NoAccess, który nie reprezentuje żadnego typu dostępu do zmiennej środowiskowej.

Przykłady

Poniższy przykład kodu przedstawia użycie GetPathList metody . Ten przykład kodu jest częścią większego przykładu podanego EnvironmentPermission dla klasy.

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

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

Uwagi

Użyj tej metody, aby uzyskać stan bieżącego uprawnienia. Aby uzyskać zarówno stany Read dostępu, jak i Write wymaga dwóch wywołań tej metody.

Uwaga

Parametr flag jest ograniczony do wartości , EnvironmentPermissionAccessktóre reprezentują pojedyncze typy dostępu do zmiennej środowiskowej. Te wartości to Read i Write. Dopuszczalne wartości flag nie obejmują NoAccess i AllAccess, które nie reprezentują pojedynczych typów dostępu do zmiennej środowiskowej.