GenericDocument.GetProperty(String) Método

Definición

Recupera el valor de propiedad con la ruta de acceso especificada como Object.

[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

path
String

Ruta de acceso que se va a buscar.

Devoluciones

Entrada con la ruta de acceso especificada como un objeto o null si no hay dicha ruta de acceso. El objeto devuelto será uno de los siguientes tipos: String[], long[], double[], boolean[], byte[][]GenericDocument[].

Atributos

Comentarios

Recupera el valor de propiedad con la ruta de acceso especificada como Object.

Una ruta de acceso puede ser un nombre de propiedad simple, como los devueltos por #getPropertyNames. También puede ser una ruta de acceso delimitada por puntos a través de la jerarquía de documentos anidada, con las propiedades anidadas GenericDocument a las que se accede a través '.' de y las propiedades repetidas se indexan opcionalmente en a través de [n].

Por ejemplo, dado lo siguiente 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"
                }

Estas son algunas rutas de acceso de ejemplo y sus resultados:

<ul><li>"from" devuelve "sender@example.com" como una String matriz con un elemento <li>"to" los dos documentos anidados que contienen información de contacto como una GenericDocument matriz con dos elementos <li"to[1]"> devuelve el segundo documento anidado que contiene la información de contacto de Marie Curie como una matriz con un GenericDocument elemento <li>"to[1].email" devuelve "curie@example.com"<li"to[100].email">, null ya que este documento en particular no tiene esos muchos elementos en su "to" matriz. <li>"to.email" agrega correos electrónicos en todos los documentos anidados que los tienen, devolviendo ["einstein@example.com", "curie@example.com"] como una String matriz con dos elementos. </ul>

Si conoce el tipo esperado de la propiedad que está recuperando, se recomienda usar una de las versiones con tipo de este método en su lugar, como #getPropertyString o #getPropertyStringArray.

Si la propiedad se asignó como una matriz vacía mediante una de las Builder#setProperty funciones, este método devolverá una matriz vacía. Si no existe ninguna propiedad de este tipo, este método devuelve null.

Nota: Si la propiedad es vacía GenericDocument[] o byte[][], este método devolverá un null valor en versiones de Android anteriores a android.os.Build.VERSION_CODES#TIRAMISU Android T. A partir de Android T, devolverá una matriz vacía si la propiedad se ha establecido como una matriz vacía, que coincide con el comportamiento de otros tipos de propiedad.

Java documentación para android.app.appsearch.GenericDocument.getProperty(java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a