Preferences.AddNodeChangeListener(INodeChangeListener) 方法

定義

命名空間:

Java.Util.Prefs

組件:

Mono.Android.dll

註冊指定的接聽程式，以接收 此節點的節點變更事件 。

[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

參數

ncl

INodeChangeListener

要加入的 NodeChangeListener。

屬性

RegisterAttribute

例外狀況

NullPointerException

如果指定的接聽程式為 ，則為 null。

IllegalStateException

如果已移除此節點，則為 。

備註

註冊指定的接聽程式，以接收 此節點的節點變更事件 。 當子節點新增至這個節點或從這個節點中移除時，會產生節點變更事件。 （單 #removeNode() 一調用會導致多個 節點變更事件，針對位於已移除節點之子樹狀結構中的每個節點產生一個。

只有在與已註冊接聽程式相同的 JVM 內進行變更時，才會保證事件，不過某些實作可能會針對在此 JVM 外部所做的變更產生事件。 變更變成永久之前，可能會產生事件。 新增或移除此節點的間接子系時，不會產生事件;呼叫端必須向每個子代註冊這類事件。

對於節點建立，可以保證很少。 由於節點是在存取時以隱含方式建立的，因此實作可能無法判斷子節點是否存在於存取前的備份存放區中（例如，因為備份存放區無法連線或快取的資訊已過期）。 在這些情況下，實作既不需要產生節點變更事件，也不需要這麼做。

的 java.util.prefs.Preferences.addNodeChangeListener(java.util.prefs.NodeChangeListener)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。