Preferences.AddNodeChangeListener(INodeChangeListener) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registra il listener specificato per ricevere gli eventi di modifica del nodo per questo nodo.
[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
Parametri
NodeChangeListener
da aggiungere.
- Attributi
Eccezioni
se il listener specificato è null
.
se il nodo è stato rimosso.
Commenti
Registra il listener specificato per ricevere gli eventi di modifica del nodo per questo nodo. Un evento di modifica del nodo viene generato quando un nodo figlio viene aggiunto o rimosso da questo nodo. Una singola #removeNode()
chiamata genera più eventi di modifica del nodo, uno per ogni nodo nel sottoalbero rooted nel nodo rimosso.
Gli eventi sono garantiti solo per le modifiche apportate all'interno della stessa JVM del listener registrato, anche se alcune implementazioni possono generare eventi per le modifiche apportate all'esterno di questa JVM. Gli eventi possono essere generati prima che le modifiche diventino permanenti. Gli eventi non vengono generati quando i discendenti indiretti di questo nodo vengono aggiunti o rimossi; un chiamante che desidera tali eventi deve essere registrato con ogni discendente.
Per quanto riguarda la creazione di nodi, è possibile effettuare poche garanzie. Poiché i nodi vengono creati in modo implicito al momento dell'accesso, potrebbe non essere possibile per un'implementazione determinare se un nodo figlio esiste nell'archivio di backup prima dell'accesso (ad esempio, perché l'archivio di backup non è raggiungibile o le informazioni memorizzate nella cache non sono aggiornate). In queste circostanze, le implementazioni non sono necessarie né per generare eventi di modifica del nodo né per impedirne l'esecuzione.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.