EnvironmentPermission.GetPathList(EnvironmentPermissionAccess) Método

Definição

Obtém todas as variáveis de ambiente com o EnvironmentPermissionAccess especificado.

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

Parâmetros

flag
EnvironmentPermissionAccess

Um dos valores EnvironmentPermissionAccess que representa um único tipo de acesso à variável de ambiente.

Retornos

Uma lista de variáveis de ambiente (separada por ponto e vírgula) para o sinalizador selecionado.

Exceções

flag não é um valor válido de EnvironmentPermissionAccess.

- ou -

flag é AllAccess, que representa mais de um tipo de acesso de variável de ambiente ou NoAccess, que não representa nenhum tipo de acesso de variável de ambiente.

Exemplos

O exemplo de código a seguir mostra o uso do GetPathList método . Este exemplo de código faz parte de um exemplo maior fornecido para a 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;
}

Comentários

Use esse método para obter o estado da permissão atual. Para obter os Read estados de acesso e Write , é necessário duas chamadas para esse método.

Observação

O flag parâmetro é limitado aos valores de EnvironmentPermissionAccess, que representam tipos únicos de acesso a variáveis de ambiente. Esses valores são Read e Write. Os valores aceitáveis para flag não incluir NoAccess e AllAccess, que não representam tipos únicos de acesso a variáveis de ambiente.

Aplica-se a

Produto Versões
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9