GenericDocument.GetProperty(String) Methode

[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

Parameter

Gibt zurück

Der Eintrag mit dem angegebenen Pfad als Objekt oder null wenn kein solcher Pfad vorhanden ist. Das zurückgegebene Objekt ist einer der folgenden Typen: String[], , long[], double[], boolean[], , . GenericDocument[]byte[][].

Attribute

RegisterAttribute

Hinweise

Ruft den Eigenschaftswert mit dem angegebenen Pfad ab als Object.

Ein Pfad kann ein einfacher Eigenschaftsname sein, z. B. die #getPropertyNamesvon . Es kann auch ein punkttrennter Pfad durch die geschachtelte Dokumenthierarchie sein, mit geschachtelten GenericDocument Eigenschaften, auf die über '.' und wiederholte Eigenschaften optional indiziert werden.[n]

Beispiel 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"
                }

Hier sind einige Beispielpfade und deren Ergebnisse:

<ul><li>"from" gibt "sender@example.com" als String Array mit einem Element <li"to"> die beiden geschachtelten Dokumente zurück, die Kontaktinformationen enthalten, als GenericDocument Array mit zwei Elementen <li>"to[1]" gibt das zweite geschachtelte Dokument zurück, das Marie Curies Kontaktinformationen als Array mit einem GenericDocument Element <li zurückgibt, null"to[100].email">"to[1].email">da dieses bestimmte Dokument nicht über viele Elemente in seinem "to" Array verfügt."curie@example.com"< <li>"to.email" aggregiert E-Mails über alle geschachtelten Dokumente, die sie enthalten, und gibt ["einstein@example.com", "curie@example.com"] als String Array mit zwei Elementen zurück. </ul>

Wenn Sie den erwarteten Typ der abzurufenden Eigenschaft kennen, empfiehlt es sich, stattdessen eine der typierten Versionen dieser Methode zu verwenden, z #getPropertyString . B. oder #getPropertyStringArray.

Wenn die Eigenschaft als leeres Array mit einer der Builder#setProperty Funktionen zugewiesen wurde, gibt diese Methode ein leeres Array zurück. Wenn überhaupt keine solche Eigenschaft vorhanden ist, gibt diese Methode zurück null.

Hinweis: Wenn die Eigenschaft ein leeres GenericDocument[] ist oder byte[][]diese Methode null einen Wert in Versionen von Android vor android.os.Build.VERSION_CODES#TIRAMISU Android T. Ab Android T wird ein leeres Array zurückgegeben, wenn die Eigenschaft als leeres Array festgelegt wurde und dem Verhalten anderer Eigenschaftstypen entspricht.

Java Dokumentation für android.app.appsearch.GenericDocument.getProperty(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.