EnvironmentPermission.GetPathList(EnvironmentPermissionAccess) Metodo

Definizione

Spazio dei nomi:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Pacchetto:

System.Security.Permissions v9.0.0-rc.2.24473.5

Origine:

EnvironmentPermission.cs

Ottiene tutte le variabili di ambiente con l'oggetto EnvironmentPermissionAccess specificato.

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

Parametri

flag

EnvironmentPermissionAccess

Uno dei valori di EnvironmentPermissionAccess che rappresenta un singolo tipo di accesso a variabili di ambiente.

Restituisce

String

Elenco delle variabili di ambiente (delimitato da punti e virgola) per il flag selezionato.

Eccezioni

ArgumentException

flag non è un valore valido di EnvironmentPermissionAccess.

-oppure-

flag è AllAccess, che rappresenta più tipi di accesso a variabili di ambiente, oppure NoAccess, che non rappresenta alcun tipo di accesso a variabili di ambiente.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del GetPathList metodo . Questo esempio di codice fa parte di un esempio più ampio fornito per la EnvironmentPermission classe .

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

Commenti

Utilizzare questo metodo per ottenere lo stato dell'autorizzazione corrente. Per ottenere entrambi Read gli stati di accesso e Write sono necessarie due chiamate a questo metodo.

Nota

Il flag parametro è limitato ai valori di EnvironmentPermissionAccess, che rappresentano singoli tipi di accesso alle variabili di ambiente. Questi valori sono Read e Write. I valori accettabili per flag non includere NoAccess e AllAccess, che non rappresentano singoli tipi di accesso alle variabili di ambiente.