GenericDocument.GetProperty(String) Méthode

[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

Paramètres

Retours

Entrée avec le chemin d’accès donné en tant qu’objet ou null s’il n’y a pas de chemin d’accès. L’objet retourné sera l’un des types suivants : String[], , long[]double[], boolean[], byte[][], . GenericDocument[]

Attributs

RegisterAttribute

Remarques

Récupère la valeur de la propriété avec le chemin d’accès donné en tant que Object.

Un chemin d’accès peut être un nom de propriété simple, tel que ceux retournés par #getPropertyNames. Il peut également s’agir d’un chemin délimité par un point via la hiérarchie de documents imbriquée, avec des propriétés imbriquées GenericDocument accessibles via '.' et des propriétés répétées éventuellement indexées via [n].

Par exemple, en fonction des éléments suivants 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"
                }

Voici quelques exemples de chemins d’accès et leurs résultats :

<ul><li>"from" retourne "sender@example.com" sous forme de String tableau avec un élément <li>"to" renvoie les deux documents imbriqués contenant des informations de contact sous forme GenericDocument de tableau avec deux éléments <li"to[1]"> renvoie le deuxième document imbriqué contenant les informations de contact de Marie Curie sous la forme d’un tableau avec un GenericDocument élément <li"to[1].email"> renvoie li>"to[100].email" renvoie<"curie@example.com"null, car ce document particulier n’a pas autant d’éléments dans son "to" tableau. <li>"to.email" agrège les e-mails sur tous les documents imbriqués qui les ont, en retournant ["einstein@example.com", "curie@example.com"] sous forme de String tableau avec deux éléments. </ul>

Si vous connaissez le type attendu de la propriété que vous récupérez, il est recommandé d’utiliser l’une des versions typées de cette méthode à la place, telles que #getPropertyString ou #getPropertyStringArray.

Si la propriété a été affectée en tant que tableau vide à l’aide de l’une Builder#setProperty des fonctions, cette méthode retourne un tableau vide. Si aucune propriété de ce type n’existe, cette méthode retourne null.

Remarque : Si la propriété est vide GenericDocument[] ou byte[][]que cette méthode retourne une null valeur dans les versions d’Android antérieures à android.os.Build.VERSION_CODES#TIRAMISU Android T. À compter d’Android T, il retourne un tableau vide si la propriété a été définie en tant que tableau vide, correspondant au comportement d’autres types de propriétés.

Java documentation pour android.app.appsearch.GenericDocument.getProperty(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.