Langage

JavaSystem.Getenv Méthode

Définition

Surcharges

Nom Description
Getenv()

Retourne une vue de carte de chaîne non modifiable de l’environnement système actuel.

Getenv(String)

Obtient la valeur de la variable d’environnement spécifiée.

Getenv()

Retourne une vue de carte de chaîne non modifiable de l’environnement système actuel.

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

Retours

l’environnement en tant que mappage de noms de variables aux valeurs

Attributs

Remarques

Retourne une vue de carte de chaîne non modifiable de l’environnement système actuel. L’environnement est un mappage dépendant du système entre les noms et les valeurs qui sont passées des processus parent à enfant.

Si le système ne prend pas en charge les variables d’environnement, une carte vide est retournée.

Le mappage retourné ne contiendra jamais de clés ou de valeurs Null. La tentative d’interrogation de la présence d’une clé ou d’une valeur Null lève un NullPointerException. La tentative d’interrogation de la présence d’une clé ou d’une valeur qui n’est pas de type String lève un ClassCastException.

La carte retournée et ses vues de collection peuvent ne pas respecter le contrat général des méthodes et Object#equals des Object#hashCode méthodes.

La carte retournée respecte généralement la casse sur toutes les plateformes.

Si un gestionnaire de sécurité existe, sa SecurityManager#checkPermission checkPermission méthode est appelée avec une {@link RuntimePermission}("getenv.*") autorisation. Cela peut entraîner une SecurityException levée.

Lors du passage d’informations à un sous-processus Java, les propriétés système sont généralement préférées aux variables d’environnement.

Ajouté à la version 1.5.

Java documentation pour java.lang.System.getenv().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

Getenv(String)

Obtient la valeur de la variable d’environnement spécifiée.

[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

Paramètres

name
String

nom de la variable d’environnement

Retours

valeur de chaîne de la variable, ou null si la variable n’est pas définie dans l’environnement système

Attributs

Remarques

Obtient la valeur de la variable d’environnement spécifiée. Une variable d’environnement est une valeur nommée externe dépendante du système.

Si un gestionnaire de sécurité existe, sa SecurityManager#checkPermission checkPermission méthode est appelée avec une {@link RuntimePermission}("getenv."+name) autorisation. Cela peut entraîner une SecurityException levée. Si aucune exception n’est levée, la valeur de la variable name est retournée.

« EnvironmentVSSystemProperties »>< i>System properties</i et >i<> environment variables</i> sont des mappages conceptuels entre les noms et les valeurs. Les deux mécanismes peuvent être utilisés pour transmettre des informations définies par l’utilisateur à un processus de Java. Les variables d’environnement ont un effet plus global, car elles sont visibles par tous les descendants du processus qui les définit, pas seulement le sous-processus immédiat Java. Ils peuvent avoir une sémantique subtilement différente, telle que l’insensitivité de cas, sur différents systèmes d’exploitation. Pour ces raisons, les variables d’environnement sont plus susceptibles d’avoir des effets secondaires inattendus. Il est préférable d’utiliser les propriétés système si possible. Les variables d’environnement doivent être utilisées lorsqu’un effet global est souhaité ou lorsqu’une interface système externe nécessite une variable d’environnement (par exemple PATH).

Sur les systèmes UNIX, le cas alphabétique est name généralement significatif, tandis que sur les systèmes Microsoft Windows ce n’est généralement pas le cas. Par exemple, l’expression System.getenv("FOO").equals(System.getenv("foo")) est susceptible d’être vraie sur Microsoft Windows.

Java documentation pour java.lang.System.getenv(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à