Partager via


Preferences.AddNodeChangeListener(INodeChangeListener) Méthode

Définition

Inscrit l’écouteur spécifié pour recevoir les événements de modification de nœud pour ce nœud.

[Android.Runtime.Register("addNodeChangeListener", "(Ljava/util/prefs/NodeChangeListener;)V", "GetAddNodeChangeListener_Ljava_util_prefs_NodeChangeListener_Handler")]
public abstract void AddNodeChangeListener (Java.Util.Prefs.INodeChangeListener? ncl);
[<Android.Runtime.Register("addNodeChangeListener", "(Ljava/util/prefs/NodeChangeListener;)V", "GetAddNodeChangeListener_Ljava_util_prefs_NodeChangeListener_Handler")>]
abstract member AddNodeChangeListener : Java.Util.Prefs.INodeChangeListener -> unit

Paramètres

ncl
INodeChangeListener

Objet NodeChangeListener à ajouter.

Attributs

Exceptions

si l’écouteur donné est null.

si ce nœud a été supprimé.

Remarques

Inscrit l’écouteur spécifié pour recevoir les événements de modification de nœud pour ce nœud. Un événement de modification de nœud est généré lorsqu’un nœud enfant est ajouté ou supprimé de ce nœud. (Un appel unique #removeNode() entraîne plusieurs événements de modification de nœud, un pour chaque nœud de la sous-arborescence racine au nœud supprimé.)

Les événements ne sont garantis que pour les modifications apportées dans la même machine virtuelle JVM que l’écouteur inscrit, bien que certaines implémentations puissent générer des événements pour les modifications apportées en dehors de cette machine virtuelle JVM. Les événements peuvent être générés avant que les modifications ne soient définitives. Les événements ne sont pas générés lorsque des descendants indirects de ce nœud sont ajoutés ou supprimés ; un appelant désirant ces événements doit s’inscrire auprès de chaque descendant.

Peu de garanties peuvent être apportées en ce qui concerne la création de nœuds. Étant donné que les nœuds sont créés implicitement lors de l’accès, il peut ne pas être possible pour une implémentation de déterminer si un nœud enfant existait dans le magasin de stockage avant d’accéder (par exemple, parce que le magasin de stockage est inaccessible ou que les informations mises en cache sont obsolètes). Dans ces circonstances, les implémentations ne sont pas requises pour générer des événements de modification de nœud ni interdire de le faire.

Documentation Java pour java.util.prefs.Preferences.addNodeChangeListener(java.util.prefs.NodeChangeListener).

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

S’applique à