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 do filho a ser pesquisado.

Retornos

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

Atributos

Exceções

se o repositório de backup não estiver disponível ou causar uma falha na operação.

Comentários

Retorna o filho nomeado se ele existir ou null se não existir. É garantido que nodeName não é nulo, não vazio, não contém o caractere de barra ('/') e não é mais do que #MAX_NAME_LENGTH 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.)

Por fim, é garantido que o nó nomeado não foi retornado por uma invocação anterior desse método ou #childSpi após a última vez em que foi removido. Em outras palavras, um valor armazenado em cache sempre será usado em preferência para invocar esse 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á invocado e o nó resultante será retornado. Se a iteração for concluída sem localizar o nome especificado, null será retornada.

Java documentação 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 usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a