GenericDocument.GetProperty(String) Método

[Android.Runtime.Register("getProperty", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetProperty_Ljava_lang_String_Handler", ApiSince=31)]
public virtual Java.Lang.Object? GetProperty(string path);

[<Android.Runtime.Register("getProperty", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetProperty_Ljava_lang_String_Handler", ApiSince=31)>]
abstract member GetProperty : string -> Java.Lang.Object
override this.GetProperty : string -> Java.Lang.Object

Parâmetros

Retornos

A entrada com o caminho fornecido como um objeto ou null se não houver esse caminho. O objeto retornado será um dos seguintes tipos: String[], , long[], double[], , boolean[], , byte[][]GenericDocument[].

Atributos

RegisterAttribute

Comentários

Recupera o valor da propriedade com o caminho fornecido como Object.

Um caminho pode ser um nome de propriedade simples, como aqueles retornados por #getPropertyNames. Também pode ser um caminho delimitado por ponto por meio da hierarquia de documentos aninhados, com propriedades aninhadas GenericDocument acessadas por meio '.' de propriedades repetidas, opcionalmente indexadas via [n].

Por exemplo, considerando o seguinte GenericDocument:

(Message) {
                    from: "sender@example.com"
                    to: [{
                        name: "Albert Einstein"
                        email: "einstein@example.com"
                      }, {
                        name: "Marie Curie"
                        email: "curie@example.com"
                      }]
                    tags: ["important", "inbox"]
                    subject: "Hello"
                }

Aqui estão alguns exemplos de caminhos e seus resultados:

<ul><li>"from" retorna "sender@example.com" como uma String matriz com um elemento <li>"to" retorna os dois documentos aninhados que contêm informações de contato como uma GenericDocument matriz com dois elementos <li"to[1]"> retorna o segundo documento aninhado que contém as informações de contato de Marie Curie como uma matriz com um GenericDocument elemento <que Li"to[1].email"> retorna<null"curie@example.com"li>"to[100].email", pois este documento em particular não tem tantos elementos em sua "to" matriz. <Li>"to.email" agrega emails em todos os documentos aninhados que os têm, retornando ["einstein@example.com", "curie@example.com"] como uma String matriz com dois elementos. </ul>

Se você souber o tipo esperado da propriedade que está recuperando, é recomendável usar uma das versões tipadas desse método, como #getPropertyString ou #getPropertyStringArray.

Se a propriedade tiver sido atribuída como uma matriz vazia usando uma das Builder#setProperty funções, esse método retornará uma matriz vazia. Se nenhuma propriedade desse tipo existir, esse método retornará null.

Observação: se a propriedade for um [] vazio GenericDocumentou byte[][], esse método retornará um null valor em versões do Android anteriores a android.os.Build.VERSION_CODES#TIRAMISU Android T. A partir do Android T, ele retornará uma matriz vazia se a propriedade tiver sido definida como uma matriz vazia, correspondendo ao comportamento de outros tipos de propriedade.

Java documentação para android.app.appsearch.GenericDocument.getProperty(java.lang.String).

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