GenericDocument.GetProperty(String) Metodo

[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

Parametri

Valori restituiti

Voce con il percorso specificato come oggetto o null se non esiste un percorso di questo tipo. L'oggetto restituito sarà uno dei tipi seguenti: String[], long[], double[]boolean[], byte[][], GenericDocument[].

Attributi

RegisterAttribute

Commenti

Recupera il valore della proprietà con il percorso specificato come Object.

Un percorso può essere un nome di proprietà semplice, ad esempio quelli restituiti da #getPropertyNames. Può anche essere un percorso delimitato da punti attraverso la gerarchia dei documenti nidificata, con proprietà annidate GenericDocument a cui si accede tramite '.' e proprietà ripetute indicizzate facoltativamente in tramite [n].

Ad esempio, dato quanto segue 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"
                }

Ecco alcuni percorsi di esempio e i relativi risultati:

<ul><li>"from" restituisce "sender@example.com" come matrice con un String elemento <li restituisce i due documenti annidati contenenti informazioni di contatto come GenericDocument matrice con due elementi <li>"to[1]" restituisce il secondo documento annidato contenente le informazioni di contatto di Marie Marie Come matrice con un GenericDocument elemento <li>"to""to[1].email"> restituisce "curie@example.com"<li"to[100].email"> perché null questo particolare documento non dispone di molti elementi nella relativa "to" matrice. <li>"to.email" aggrega i messaggi di posta elettronica in tutti i documenti annidati che li contengono, restituendo ["einstein@example.com", "curie@example.com"] come String matrice con due elementi. </ul>

Se si conosce il tipo previsto della proprietà che si sta recuperando, è consigliabile usare una delle versioni tipate di questo metodo, ad esempio #getPropertyString o #getPropertyStringArray.

Se la proprietà è stata assegnata come matrice vuota usando una delle Builder#setProperty funzioni, questo metodo restituirà una matrice vuota. Se non esiste alcuna proprietà di questo tipo, questo metodo restituisce null.

Nota: se la proprietà è vuota GenericDocument[] o byte[][], questo metodo restituirà un null valore nelle versioni di Android precedenti a android.os.Build.VERSION_CODES#TIRAMISU Android T. A partire da Android T restituirà una matrice vuota se la proprietà è stata impostata come matrice vuota, corrispondente al comportamento di altri tipi di proprietà.

per android.app.appsearch.GenericDocument.getProperty(java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.