JavaSystem.Getenv メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| Getenv() |
現在のシステム環境の変更できない文字列マップ ビューを返します。 |
| Getenv(String) |
指定した環境変数の値を取得します。 |
Getenv()
現在のシステム環境の変更できない文字列マップ ビューを返します。
[Android.Runtime.Register("getenv", "()Ljava/util/Map;", "")]
public static System.Collections.Generic.IDictionary<string,string> Getenv();
[<Android.Runtime.Register("getenv", "()Ljava/util/Map;", "")>]
static member Getenv : unit -> System.Collections.Generic.IDictionary<string, string>
返品
環境変数の値へのマップとしての環境
- 属性
注釈
現在のシステム環境の変更できない文字列マップ ビューを返します。 この環境は、名前から値へのシステム依存のマッピングであり、親プロセスから子プロセスに渡されます。
システムが環境変数をサポートしていない場合は、空のマップが返されます。
返されるマップに null キーまたは値が含まれることはありません。 null キーまたは値の存在を照会しようとすると、 NullPointerExceptionがスローされます。
String型ではないキーまたは値の存在を照会しようとすると、ClassCastExceptionがスローされます。
返されたマップとそのコレクション ビューは、 Object#equals メソッドと Object#hashCode メソッドの一般的なコントラクトに従わない場合があります。
返されるマップは、通常、すべてのプラットフォームで大文字と小文字が区別されます。
セキュリティ マネージャーが存在する場合、その SecurityManager#checkPermission checkPermission メソッドは {@link RuntimePermission}("getenv.*") のアクセス許可を使用して呼び出されます。 これにより、 SecurityException がスローされる可能性があります。
Javaサブプロセスに情報を渡す場合、一般に、システム プロパティは環境変数よりも優先されます。
1\.5 で追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
Getenv(String)
指定した環境変数の値を取得します。
[Android.Runtime.Register("getenv", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public static string? Getenv(string name);
[<Android.Runtime.Register("getenv", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
static member Getenv : string -> string
パラメーター
- name
- String
環境変数の名前
返品
変数の文字列値。変数がシステム環境で定義されていない場合はnull
- 属性
注釈
指定した環境変数の値を取得します。 環境変数は、システム依存の外部の名前付き値です。
セキュリティ マネージャーが存在する場合、その SecurityManager#checkPermission checkPermission メソッドは {@link RuntimePermission}("getenv."+name) のアクセス許可を使用して呼び出されます。 これにより、 SecurityException がスローされる可能性があります。 例外がスローされない場合は、変数 name の値が返されます。
"EnvironmentVSSystemProperties"><i>System プロパティ</i> および <i>environment 変数</i> は、どちらも名前と値の概念的なマッピングです。 どちらのメカニズムも、ユーザー定義情報をJava プロセスに渡すために使用できます。 環境変数は、即時のJavaサブプロセスだけでなく、それらを定義するプロセスのすべての子孫に表示されるため、よりグローバルな効果があります。 異なるオペレーティング システムでは、大文字と小文字の区別など、微妙に異なるセマンティクスを持つことができます。 このような理由から、環境変数は意図しない副作用を持つ可能性が高くなります。 可能な場合は、システム プロパティを使用することをお勧めします。 環境変数は、グローバル効果が必要な場合、または外部システム インターフェイスに環境変数 ( PATH など) が必要な場合に使用する必要があります。
UNIX システムでは、通常、nameのアルファベット形式のケースは重要ですが、Microsoft Windows システムでは通常は重要ではありません。 たとえば、式System.getenv("FOO").equals(System.getenv("foo"))は、Microsoft Windowsで true になる可能性があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。