ProcessBuilder.Environment Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une vue de carte de chaîne de l’environnement de ce générateur de processus.
[Android.Runtime.Register("environment", "()Ljava/util/Map;", "")]
public System.Collections.Generic.IDictionary<string,string>? Environment();[<Android.Runtime.Register("environment", "()Ljava/util/Map;", "")>]
member this.Environment : unit -> System.Collections.Generic.IDictionary<string, string>Retours
environnement de ce générateur de processus
- Attributs
Remarques
Retourne une vue de carte de chaîne de l’environnement de ce générateur de processus.
Chaque fois qu’un générateur de processus est créé, l’environnement est initialisé dans une copie de l’environnement de processus actuel (voir System#getenv()). Les sous-processus démarrés par la suite par la méthode de #start() cet objet utilisent cette carte comme environnement.
L’objet retourné peut être modifié à l’aide d’opérations ordinaires java.util.Map Map . Ces modifications seront visibles pour les sous-processus démarrés via la #start() méthode. Deux ProcessBuilder instances contiennent toujours des environnements de processus indépendants, de sorte que les modifications apportées à la carte retournée ne seront jamais reflétées dans une autre ProcessBuilder instance ou les valeurs retournées par System#getenv System.getenv.
Si le système ne prend pas en charge les variables d’environnement, une carte vide est retournée.
La carte retournée n’autorise pas les clés ou valeurs Null. Toute tentative d’insertion ou 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.
Le comportement de la carte retournée dépend du système. Un système peut ne pas autoriser les modifications apportées aux variables d’environnement ou interdire certains noms ou valeurs de variables. Pour cette raison, les tentatives de modification de la carte peuvent échouer UnsupportedOperationException ou IllegalArgumentException si la modification n’est pas autorisée par le système d’exploitation.
Étant donné que le format externe des noms et des valeurs des variables d'environnement dépend du système, il peut ne pas y avoir de mappage un-à-un entre eux et les chaînes Unicode de Java. Néanmoins, la carte est implémentée de telle manière que les variables d’environnement qui ne sont pas modifiées par Java code auront une représentation native non modifiée dans le sous-processus.
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 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.
Java documentation pour java.lang.ProcessBuilder.environment().
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.