Metode System.Environment.GetEnvironmentVariable

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

Metode ini GetEnvironmentVariable mengambil nilai variabel lingkungan dari proses saat ini.

Nama variabel lingkungan peka huruf besar/kecil pada sistem seperti Unix tetapi tidak peka huruf besar/kecil di Windows.

Nota

Modifikasi lingkungan dalam proses yang dibuat oleh pustaka asli tidak dilihat oleh penelepon terkelola. Sebaliknya, modifikasi seperti itu yang dibuat oleh pemanggil yang terkelola tidak terlihat oleh perpustakaan bawaan.

metode GetEnvironmentVariable(String)

Metode ini GetEnvironmentVariable(String) mengambil variabel lingkungan dari blok lingkungan dari proses saat ini saja. Ini setara dengan memanggil metode GetEnvironmentVariable(String, EnvironmentVariableTarget) dengan nilai target dari EnvironmentVariableTarget.Process.

Untuk mengambil semua variabel lingkungan bersama dengan nilainya, panggil GetEnvironmentVariables metode .

Pada sistem Windows

Pada sistem Windows, blok lingkungan dari proses saat ini meliputi:

• Semua variabel lingkungan yang disediakan oleh proses induk yang membuatnya. Misalnya, aplikasi .NET yang diluncurkan dari jendela konsol mewarisi semua variabel lingkungan jendela konsol.

  Jika tidak ada proses induk, variabel lingkungan per mesin dan per pengguna digunakan sebagai gantinya. Misalnya, jendela konsol baru memiliki semua variabel lingkungan per mesin dan per pengguna yang ditentukan pada saat diluncurkan.

• Variabel apa pun yang ditambahkan ke blok proses saat proses berjalan dengan memanggil metode SetEnvironmentVariable(String, String) atau metode SetEnvironmentVariable(String, String, EnvironmentVariableTarget) dengan nilai targetEnvironmentVariableTarget.Process. Variabel lingkungan ini bertahan sampai aplikasi .NET berakhir.

Jika variabel lingkungan dibuat setelah proses dimulai, Anda dapat menggunakan metode ini untuk mengambil hanya variabel yang dibuat dengan memanggil SetEnvironmentVariable(String, String) metode atau SetEnvironmentVariable(String, String, EnvironmentVariableTarget) metode dengan target nilai .EnvironmentVariableTarget.Process.

Pada sistem seperti Unix

Pada sistem seperti Unix, blok lingkungan dari proses saat ini mencakup variabel lingkungan berikut:

• Semua variabel lingkungan yang disediakan oleh proses induk yang membuatnya. Untuk aplikasi .NET yang diluncurkan dari shell, ini mencakup semua variabel lingkungan yang ditentukan dalam shell.

• Variabel apa pun yang ditambahkan ke blok proses saat proses berjalan dengan memanggil metode SetEnvironmentVariable(String, String) atau metode SetEnvironmentVariable(String, String, EnvironmentVariableTarget) dengan nilai targetEnvironmentVariableTarget.Process. Variabel lingkungan ini bertahan sampai aplikasi .NET berakhir.

.NET pada sistem seperti Unix tidak mendukung variabel lingkungan per mesin atau per pengguna.

metode GetEnvironmentVariable(String, EnvironmentVariableTarget)

Untuk mengambil semua variabel lingkungan bersama dengan nilainya, panggil GetEnvironmentVariables metode .

Pada sistem Windows

Pada Windows, target parameter menentukan apakah variabel lingkungan diambil dari proses saat ini atau dari kunci registri sistem operasi Windows untuk pengguna atau komputer lokal saat ini. Semua variabel lingkungan per pengguna dan per mesin secara otomatis disalin ke blok lingkungan proses saat ini, seperti halnya variabel lingkungan lain yang tersedia untuk proses induk yang membuat proses .NET. Namun, variabel lingkungan yang ditambahkan hanya ke blok lingkungan dari proses saat ini melalui pemanggilan metode SetEnvironmentVariable(String, String) atau metode SetEnvironmentVariable(String, String, EnvironmentVariableTarget) dengan nilai targetEnvironmentVariableTarget.Process akan bertahan hanya selama proses berlangsung.

Pada sistem seperti Unix

Pada sistem seperti Unix, metode GetEnvironmentVariable(String, EnvironmentVariableTarget) mendukung nilai target saja. Panggilan yang memiliki nilai target, EnvironmentVariableTarget.Machine atau EnvironmentVariableTarget.User tidak didukung dan akan mengembalikan null.

Variabel lingkungan per proses adalah:

• Diturunkan dari proses induk, biasanya shell yang digunakan untuk menjalankan dotnet.exe, atau meluncurkan aplikasi .NET.

• Didefinisikan oleh panggilan baik metode SetEnvironmentVariable(String, String) atau metode SetEnvironmentVariable(String, String, EnvironmentVariableTarget) dengan nilai target sebesar EnvironmentVariableTarget.Process. Variabel lingkungan ini hanya bertahan sampai dotnet proses atau aplikasi .NET berakhir.