EnvironmentPermission.GetPathList(EnvironmentPermissionAccess) Méthode

Définition

Espace de noms:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Obtient toutes les variables d’environnement avec la valeur EnvironmentPermissionAccess spécifiée.

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

Paramètres

flag

EnvironmentPermissionAccess

Une des valeurs EnvironmentPermissionAccess représentant un seul type d’accès aux variables d’environnement.

Retours

String

Liste des variables d’environnement (séparées par des points-virgules) pour l’indicateur sélectionné.

Exceptions

ArgumentException

flag n’est pas une valeur valide de EnvironmentPermissionAccess.

- ou -

flag est AllAccess, qui représente plusieurs types d’accès aux variables d’environnement, ou NoAccess, qui ne représente aucun type d’accès aux variables d’environnement.

Exemples

L’exemple de code suivant montre l’utilisation de la GetPathList méthode . Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

Utilisez cette méthode pour obtenir l’état de l’autorisation actuelle. Pour obtenir à la fois les Read états et Write d’accès, deux appels à cette méthode sont nécessaires.

Notes

Le flag paramètre est limité aux valeurs de EnvironmentPermissionAccess, qui représentent des types uniques d’accès aux variables d’environnement. Ces valeurs sont Read et Write. Les valeurs acceptables n’incluent flagNoAccess pas et AllAccess, qui ne représentent pas des types uniques d’accès aux variables d’environnement.