Environment.GetEnvironmentVariable Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Recupera il valore di una variabile di ambiente.

Overload

GetEnvironmentVariable(String)	Recupera dal processo corrente il valore di una variabile di ambiente.
GetEnvironmentVariable(String, EnvironmentVariableTarget)	Recupera il valore di una variabile di ambiente dal processo corrente o dalla chiave del Registro del sistema operativo Windows per l'utente corrente o per il computer locale.

GetEnvironmentVariable(String)

Origine:

Environment.cs

Recupera dal processo corrente il valore di una variabile di ambiente.

C#

public static string? GetEnvironmentVariable (string variable);

Parametri

variable

String

Nome della variabile di ambiente.

Restituisce

String

Valore della variabile di ambiente specificata nel parametro variable o null se la variabile di ambiente non viene trovata.

Eccezioni

ArgumentNullException

variable è null.

SecurityException

Il chiamante non ha l'autorizzazione richiesta per eseguire questa operazione.

Esempio

Nell'esempio seguente viene usato il GetEnvironmentVariable metodo per recuperare la windir variabile di ambiente che contiene il percorso della directory di Windows.

C#

using System;
using System.IO;

public class Example
{
   public static void Main()
   {
      if (Environment.OSVersion.Platform == PlatformID.Win32NT)
      {
         // Change the directory to %WINDIR%
         Environment.CurrentDirectory = Environment.GetEnvironmentVariable("windir");
         DirectoryInfo info = new DirectoryInfo(".");

         Console.WriteLine("Directory Info:   " + info.FullName);
      }
      else
      {
         Console.WriteLine("This example runs on Windows only.");
      }
   }
}
// The example displays output like the following on a .NET implementation running on Windows:
//        Directory Info:   C:\windows
// The example displays the following output on a .NET implementation on Unix-based systems:
//        This example runs on Windows only.

Nell'esempio seguente viene tentato di recuperare il valore di una variabile di ambiente denominata Test1 dal blocco di ambiente del processo. Se la variabile non esiste, l'esempio lo crea e recupera il relativo valore. Nell'esempio viene visualizzato il valore della variabile. Se l'esempio ha creato la variabile, chiama anche il GetEnvironmentVariables(EnvironmentVariableTarget) metodo con ogni membro dell'enumerazione EnvironmentVariableTarget per stabilire che la variabile può essere recuperata solo dal blocco di ambiente del processo corrente. Infine, se l'esempio ha creato la variabile, la elimina.

C#

using System;

public class Example
{
   public static void Main()
   {
      string value;
      bool toDelete = false;

      // Check whether the environment variable exists.
      value = Environment.GetEnvironmentVariable("Test1");
      // If necessary, create it.
      if (value == null)
      {
         Environment.SetEnvironmentVariable("Test1", "Value1");
         toDelete = true;

         // Now retrieve it.
         value = Environment.GetEnvironmentVariable("Test1");
      }
      // Display the value.
      Console.WriteLine($"Test1: {value}\n");

      // Confirm that the value can only be retrieved from the process
      // environment block if running on a Windows system.
      if (Environment.OSVersion.Platform == PlatformID.Win32NT)
      {
         Console.WriteLine("Attempting to retrieve Test1 from:");
         foreach (EnvironmentVariableTarget enumValue in
                           Enum.GetValues(typeof(EnvironmentVariableTarget))) {
            value = Environment.GetEnvironmentVariable("Test1", enumValue);
            Console.WriteLine($"   {enumValue}: {(value != null ? "found" : "not found")}");
         }
         Console.WriteLine();
      }

      // If we've created it, now delete it.
      if (toDelete) {
         Environment.SetEnvironmentVariable("Test1", null);
         // Confirm the deletion.
         if (Environment.GetEnvironmentVariable("Test1") == null)
            Console.WriteLine("Test1 has been deleted.");
      }
   }
}
// The example displays the following output if run on a Windows system:
//      Test1: Value1
//
//      Attempting to retrieve Test1 from:
//         Process: found
//         User: not found
//         Machine: not found
//
//      Test1 has been deleted.
//
// The example displays the following output if run on a Unix-based system:
//      Test1: Value1
//
//      Test1 has been deleted.

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per Environment.GetEnvironmentVariable.

Vedi anche

• GetEnvironmentVariables()
• SetEnvironmentVariable(String, String)
• EnvironmentVariableTarget

GetEnvironmentVariable(String, EnvironmentVariableTarget)

Origine:

Environment.cs

Recupera il valore di una variabile di ambiente dal processo corrente o dalla chiave del Registro del sistema operativo Windows per l'utente corrente o per il computer locale.

C#

public static string? GetEnvironmentVariable (string variable, EnvironmentVariableTarget target);

Parametri

variable

String

Nome di una variabile di ambiente.

target

EnvironmentVariableTarget

Uno dei valori di EnvironmentVariableTarget. È supportato solo Process in .NET in esecuzione nei sistemi unix.

Restituisce

String

Valore della variabile di ambiente specificata nei parametri variable e target oppure null se la variabile di ambiente non viene trovata.

Eccezioni

ArgumentNullException

variable è null.

ArgumentException

target non è un valore valido di EnvironmentVariableTarget.

SecurityException

Il chiamante non ha l'autorizzazione richiesta per eseguire questa operazione.

Esempio

Nell'esempio seguente vengono create variabili di ambiente per le EnvironmentVariableTarget.Processdestinazioni , EnvironmentVariableTarget.Usere Machine verifica se il Registro di sistema operativo contiene le variabili di ambiente utente e computer, quindi elimina le variabili di ambiente. Poiché i sistemi .NET in unix non supportano variabili di ambiente per utente e per computer, solo SetEnvironmentVariable(String, String) e SetEnvironmentVariable(String, String, EnvironmentVariableTarget) con un valore di archiviare correttamente una variabile di EnvironmentVariableTarget.Process ambiente al blocco di ambiente di processo.

C#

using System;
using System.Collections;
using Microsoft.Win32;

class Sample
{
    public static void Main()
    {
        // Environment variable names for default, process, user, and machine targets.
        string defaultEnvVar = nameof(defaultEnvVar);
        string processEnvVar = nameof(processEnvVar);
        string userEnvVar = nameof(userEnvVar);
        string machineEnvVar = nameof(machineEnvVar);

        string dft = nameof(dft);
        string process = nameof(process);
        string user = nameof(user);
        string machine = nameof(machine);

        // Set the environment variable for each target.
        Console.WriteLine("Setting environment variables for each target...\n");
        // The default target (the current process).
        Environment.SetEnvironmentVariable(defaultEnvVar, dft);
        // The current process.
        Environment.SetEnvironmentVariable(processEnvVar, process,
                                           EnvironmentVariableTarget.Process);
        // The current user.
        Environment.SetEnvironmentVariable(userEnvVar, user,
                                           EnvironmentVariableTarget.User);
        // The local machine.
        Environment.SetEnvironmentVariable(machineEnvVar, machine,
                                           EnvironmentVariableTarget.Machine);

        // Define an array of environment variables.
        string[] envVars = { defaultEnvVar,processEnvVar, userEnvVar, machineEnvVar };

        // Try to get the environment variables from each target.
        // The default (no specified target).
        Console.WriteLine("Retrieving environment variables from the default target:");
        foreach (var envVar in envVars)
        {
          var value = Environment.GetEnvironmentVariable(envVar) ?? "(none)";
          Console.WriteLine($"   {envVar}: {value}");
        }
        // The process block.
        Console.WriteLine("\nRetrieving environment variables from the Process target:");
        foreach (var envVar in envVars)
        {
          var value = Environment.GetEnvironmentVariable(envVar, EnvironmentVariableTarget.Process) ?? "(none)";
          Console.WriteLine($"   {envVar}: {value}");
        }
        // The user block.
        Console.WriteLine("\nRetrieving environment variables from the User target:");
        foreach (var envVar in envVars)
        {
          var value = Environment.GetEnvironmentVariable(envVar, EnvironmentVariableTarget.User) ?? "(none)";
          Console.WriteLine($"   {envVar}: {value}");
        }
        // The machine block.
        Console.WriteLine("\nRetrieving environment variables from the Machine target:");
        foreach (var envVar in envVars)
        {
          var value = Environment.GetEnvironmentVariable(envVar, EnvironmentVariableTarget.Machine) ?? "(none)";
          Console.WriteLine($"   {envVar}: {value}");
        }

        // Delete the environment variable for each target.
        Console.WriteLine("\nDeleting environment variables for each target...\n");
        // The default target (the current process).
        Environment.SetEnvironmentVariable(defaultEnvVar, null);
        // The current process.
        Environment.SetEnvironmentVariable(processEnvVar, null,
                                           EnvironmentVariableTarget.Process);
        // The current user.
        Environment.SetEnvironmentVariable(userEnvVar, null,
                                           EnvironmentVariableTarget.User);
        // The local machine.
        Environment.SetEnvironmentVariable(machineEnvVar, null,
                                           EnvironmentVariableTarget.Machine);
    }
}
// The example displays the following output if run on a Windows system:
//      Setting environment variables for each target...
//
//      Retrieving environment variables from the default target:
//        defaultEnvVar: dft
//        processEnvVar: process
//        userEnvVar: user
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the Process target:
//        defaultEnvVar: dft
//        processEnvVar: process
//        userEnvVar: user
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the User target:
//        defaultEnvVar: (none)
//        processEnvVar: (none)
//        userEnvVar: user
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the Machine target:
//        defaultEnvVar: (none)
//        processEnvVar: (none)
//        userEnvVar: (none)
//        machineEnvVar: machine
//
//      Deleting environment variables for each target...
//
// The example displays the following output if run on a Unix-based system:
//
//      Setting environment variables for each target...
//
//      Retrieving environment variables from the default target:
//        defaultEnvVar: dft
//        processEnvVar: process
//        userEnvVar: (none)
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the Process target:
//        defaultEnvVar: dft
//        processEnvVar: process
//        userEnvVar: (none)
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the User target:
//        defaultEnvVar: (none)
//        processEnvVar: (none)
//        userEnvVar: (none)
//        machineEnvVar: (none)
//
//      Retrieving environment variables from the Machine target:
//        defaultEnvVar: (none)
//        processEnvVar: (none)
//        userEnvVar: (none)
//        machineEnvVar: (none)
//
//      Deleting environment variables for each target...

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per Environment.GetEnvironmentVariable.

Vedi anche

• SetEnvironmentVariable(String, String, EnvironmentVariableTarget)
• GetEnvironmentVariables()
• EnvironmentVariableTarget