EnvironmentPermission.GetPathList(EnvironmentPermissionAccess) Methode

Definition

Namespace:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Ruft alle Umgebungsvariablen mit dem angegebenen EnvironmentPermissionAccess ab.

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

Parameter

flag

EnvironmentPermissionAccess

Einer der EnvironmentPermissionAccess-Werte, der einen einzelnen Zugriffstyp für Umgebungsvariablen darstellt.

Gibt zurück

String

Eine Liste von Umgebungsvariablen (durch Semikolon getrennt) für das ausgewählte Flag.

Ausnahmen

ArgumentException

flag ist kein gültiger Wert von EnvironmentPermissionAccess.

- oder -

flag hat den Wert AllAccess, der mehrere Zugriffstypen für Umgebungsvariablen darstellt, oder NoAccess, der keinen Zugriffstyp für Umgebungsvariablen darstellt.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der GetPathList -Methode. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die EnvironmentPermission-Klasse bereitgestellt wird.

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

Hinweise

Verwenden Sie diese Methode, um den Status der aktuellen Berechtigung abzurufen. Zum Abrufen von Sowohl- als auch ReadWrite Zugriffszuständen sind zwei Aufrufe dieser Methode erforderlich.

Hinweis

Der flag Parameter ist auf die Werte von EnvironmentPermissionAccessbeschränkt, die einzelne Typen des Zugriffs auf Umgebungsvariablen darstellen. Diese Werte sind Read und Write. Die Werte, die zulässig sind, nicht flag enthalten NoAccess und AllAccess, die keine einzelnen Typen des Zugriffs auf Umgebungsvariablen darstellen.