Compartilhar via


AbstractPreferences.GetChild(String) Método

Definição

Retorna o filho nomeado se ele existir ou null se não existir.

[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

Parâmetros

nodeName
String

nome da criança a ser pesquisada.

Retornos

o filho nomeado, se existir, ou nulo, se não existir.

Atributos

Exceções

se o armazenamento de backup não estiver disponível ou causar uma falha de operação.

Comentários

Retorna o filho nomeado se ele existir ou null se não existir. É garantido que não é nulo, não vazio, não contém o caractere de barra ('/') e não é mais do #MAX_NAME_LENGTH que nodeName caracteres. Além disso, é garantido que esse nó não foi removido. (O implementador não precisa verificar nenhuma dessas coisas se optar por substituir esse método.)

Finalmente, é garantido que o nó nomeado não tenha sido retornado por uma invocação anterior desse método ou #childSpi após a última vez que ele foi removido. Em outras palavras, um valor armazenado em cache sempre será usado em preferência à invocação desse método. (O implementador não precisa manter seu próprio cache de filhos retornados anteriormente se optar por substituir esse método.)

Essa implementação obtém o bloqueio desse nó de preferência, invoca #childrenNames() para obter uma matriz dos nomes dos filhos desse nó e itera sobre a matriz comparando o nome de cada filho com o nome do nó especificado. Se um nó filho tiver o nome correto, o #childSpi(String) método será chamado e o nó resultante será retornado. Se a iteração for concluída sem encontrar o nome especificado, null será retornada.

Documentação Java para java.util.prefs.AbstractPreferences.getChild(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a