EnvironmentVariableTarget Перечисление

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

System.Runtime.Extensions.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Задает расположение, в котором хранится переменная среды, или из которого она извлекается при выполнении операции Set или Get.

C#

public enum EnvironmentVariableTarget

C#

[System.Runtime.InteropServices.ComVisible(true)]
public enum EnvironmentVariableTarget

Наследование

Object

ValueType

Enum

EnvironmentVariableTarget

Атрибуты

ComVisibleAttribute

Поля

Machine	2	Переменная среды хранится в разделе реестра HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment операционной системы Windows или извлекается из этого раздела. Это значение следует использовать в реализациях .NET только в системах Windows.
Process	0	Переменная среды хранится в блоке переменных среды, связанном с текущим процессом, или извлекается из этого блока.
User	1	Переменная среды хранится в разделе реестра HKEY_CURRENT_USER\Environment операционной системы Windows или извлекается из этого раздела. Это значение следует использовать в реализациях .NET только в системах Windows.

Примеры

В следующем примере перечисление EnvironmentVariableTarget используется в методах, которые создают, извлекают и удаляют переменные среды. Выходные данные примера показывают, что переменные среды хранятся и извлекаются без указания EnvironmentVariableTarget значения, хранятся в блоке среды, связанном с текущим процессом (EnvironmentVariableTarget.Process). В примере выходных данных систем под управлением Unix также показано, что пытается определить переменную среды со значением, отличным от EnvironmentVariableTarget.Process игнорируемого.

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...

Комментарии

Перечисление EnvironmentVariableTarget используется определенными перегрузками Environment.SetEnvironmentVariableEnvironment.GetEnvironmentVariableEnvironment.GetEnvironmentVariables и методами для указания расположения или целевого объекта, где хранится или извлекается имя и значение переменной среды.

Целевой объект может быть одним из трех расположений:

• Блок среды, связанный с текущим процессом (EnvironmentVariableTarget.Process).

  Пользователь создает переменную среды в операции задания. После завершения процесса операционная система уничтожает переменную среды в этом процессе.

• Windows раздел реестра операционной системы, зарезервированный для переменных среды, связанных с текущим пользователем (EnvironmentVariableTarget.User).

  В системах Windows, когда пользователь создает переменную среды в операции задания, операционная система сохраняет переменную среды в системном реестре, но не в текущем процессе. Если пользователь запускает новый процесс, операционная система копирует переменную среды из реестра в этот процесс. После завершения процесса операционная система уничтожает переменную среды в этом процессе. Однако переменная среды в реестре сохраняется, пока пользователь не удалит ее программным способом или с помощью средства операционной системы.

  В системах под управлением Unix попытка создать переменную среды без EnvironmentVariable.User эффекта и попытаться получить переменную окружения с помощью EnvironmentVariable.User возвращаемых данных null (в C#) или Nothing (в Visual Basic).

• Раздел реестра, зарезервированный для переменных среды, связанных со всеми пользователями на локальном компьютере (EnvironmentVariableTarget.Machine).

  Когда пользователь создает переменную среды в операции набора, операционная система сохраняет переменную среды в системном реестре, но не в текущем процессе. Если любой пользователь на локальном компьютере запускает новый процесс, операционная система копирует переменную среды из реестра в этот процесс. После завершения процесса операционная система уничтожает переменную среды в этом процессе. Однако переменная среды в реестре сохраняется до тех пор, пока пользователь не удалит ее программным способом или с помощью средства операционной системы.

  В системах под управлением Unix попытка создать переменную среды без EnvironmentVariable.Machine эффекта и попытаться получить переменную окружения с помощью EnvironmentVariable.Machine возвращаемых данных null (в C#) или Nothing (в Visual Basic).

Применяется к