Preferences.AddNodeChangeListener(INodeChangeListener) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したリスナーを登録して、このノードのノード変更イベントを受信します。
[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
パラメーター
追加する NodeChangeListener
です。
- 属性
例外
指定されたリスナー null
が .
このノードが削除されている場合は 。
注釈
指定したリスナーを登録して、このノードのノード変更イベントを受信します。 ノード変更イベントは、子ノードがこのノードに追加またはこのノードから削除されるときに生成されます。 (1 回 #removeNode()
の呼び出しでは、複数 のノード変更イベントが発生します。これは、削除されたノードをルートとするサブツリー内のすべてのノードに対して 1 つです)。
イベントは、登録されたリスナーと同じ JVM 内で行われた変更に対してのみ保証されますが、一部の実装では、この JVM の外部で行われた変更のイベントが生成される場合があります。 変更が永続的になる前にイベントが生成される場合があります。 イベントは、このノードの間接的な子孫が追加または削除されるときに生成されません。このようなイベントを望む呼び出し元は、各子孫に登録する必要があります。
ノードの作成に関して、いくつかの保証を行うことができます。 ノードはアクセス時に暗黙的に作成されるため、アクセス前に子ノードがバッキング ストアに存在していたかどうかを実装で判断できない場合があります (たとえば、バッキング ストアに到達できないか、キャッシュされた情報が最新ではないため)。 このような状況では、実装はノード変更イベントを生成する必要も禁止もされません。
の Java ドキュメントjava.util.prefs.Preferences.addNodeChangeListener(java.util.prefs.NodeChangeListener)
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。