Partilhar via


ApplicationBase.GetEnvironmentVariable(String) Método

Definição

Retorna o valor da variável de ambiente especificada.

public:
 System::String ^ GetEnvironmentVariable(System::String ^ name);
public string GetEnvironmentVariable (string name);
member this.GetEnvironmentVariable : string -> string
Public Function GetEnvironmentVariable (name As String) As String

Parâmetros

name
String

Um String que contém o nome da variável de ambiente.

Retornos

Um String que contém o valor da variável de ambiente com o nome name.

Exceções

name é Nothing.

A variável de ambiente especificada por name não existe.

O código de chamada não tem EnvironmentPermission com o acesso Read.

Exemplos

Este exemplo usa o My.Application.GetEnvironmentVariable método para obter e exibir o valor da variável de ambiente PATH, se disponível. Caso contrário, ele exibirá uma mensagem indicando que a variável de ambiente PATH não existe.

Private Sub TestGetEnvironmentVariable()
    Try
        MsgBox("PATH = " & My.Application.GetEnvironmentVariable("PATH"))
    Catch ex As System.ArgumentException
        MsgBox("Environment variable 'PATH' does not exist.")
    End Try
End Sub

Comentários

O My.Application.GetEnvironmentVariable método retorna a variável de ambiente com o nome name. Esse método é semelhante a Environment.GetEnvironmentVariable(String), exceto que esse método gera uma exceção se a variável de ambiente especificada por name não existir.

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Forms Sim
Biblioteca de Classes Sim
Aplicativo do Console Sim
Biblioteca de Controle Windows Forms Sim
Biblioteca de Controles da Web Não
Serviço do Windows Sim
Site Não

Aplica-se a

Confira também