Freigeben über


AbstractPreferences.GetChild(String) Methode

Definition

Gibt das benannte untergeordnete Element zurück, wenn es vorhanden ist oder null wenn dies nicht der Fall ist.

[Android.Runtime.Register("getChild", "(Ljava/lang/String;)Ljava/util/prefs/AbstractPreferences;", "GetGetChild_Ljava_lang_String_Handler")]
protected virtual Java.Util.Prefs.AbstractPreferences? GetChild (string? nodeName);
[<Android.Runtime.Register("getChild", "(Ljava/lang/String;)Ljava/util/prefs/AbstractPreferences;", "GetGetChild_Ljava_lang_String_Handler")>]
abstract member GetChild : string -> Java.Util.Prefs.AbstractPreferences
override this.GetChild : string -> Java.Util.Prefs.AbstractPreferences

Parameter

nodeName
String

Name des untergeordneten Elements, nach dem gesucht werden soll.

Gibt zurück

das benannte untergeordnete Element, falls vorhanden, oder null, wenn dies nicht der Fall ist.

Attribute

Ausnahmen

wenn der Sicherungsspeicher nicht verfügbar ist oder ein Vorgangsfehler verursacht.

Hinweise

Gibt das benannte untergeordnete Element zurück, wenn es vorhanden ist oder null wenn dies nicht der Fall ist. Es wird sichergestellt, dass nodeName es sich nicht um null, nicht leer handelt, nicht das Schrägstrichzeichen ('/') enthält und nicht mehr als Zeichen ist #MAX_NAME_LENGTH . Außerdem wird sichergestellt, dass dieser Knoten nicht entfernt wurde. (Der Implementierer muss nicht nach einer dieser Dinge suchen, wenn er diese Methode außer Kraft setzen möchte.)

Schließlich wird sichergestellt, dass der benannte Knoten nicht durch einen vorherigen Aufruf dieser Methode oder #childSpi nach dem letzten Entfernen zurückgegeben wurde. Mit anderen Worten, ein zwischengespeicherter Wert wird immer vor dem Aufrufen dieser Methode verwendet. (Der Implementierer muss seinen eigenen Cache von zuvor zurückgegebenen Untergeordneten nicht beibehalten, wenn er diese Methode außer Kraft setzen möchte.)

Diese Implementierung ruft die Sperre dieses Einstellungsknotens ab, ruft #childrenNames() auf, um ein Array der Namen der untergeordneten Elemente dieses Knotens abzurufen, und durchläuft das Array, das den Namen jedes untergeordneten Knotens mit dem angegebenen Knotennamen vergleicht. Wenn ein untergeordneter Knoten den richtigen Namen hat, wird die #childSpi(String) Methode aufgerufen, und der resultierende Knoten wird zurückgegeben. Wenn die Iteration abgeschlossen ist, ohne den angegebenen Namen zu finden, null wird diese zurückgegeben.

Java-Dokumentation für java.util.prefs.AbstractPreferences.getChild(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: