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)。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。