GenericDocument.GetProperty(String) 方法

[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

參數

傳回

以該路徑作為物件的條目，或 null 若不存在此類路徑。 回傳的物件會是以下類型之一：String[]， long[]GenericDocument[]double[]boolean[]byte[][]。

屬性

RegisterAttribute

備註

以給定路徑 Object為 的方式取得屬性值。

路徑可以是簡單的屬性名稱，例如由 #getPropertyNames返回的。 它也可以是巢狀文件階層中的點分隔路徑，巢狀 GenericDocument 屬性透過 '.' 存取，重複屬性則可選擇性地 [n]透過 索引。

例如，給定以下 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"
                }

以下是一些範例路徑及其結果：

<ul><li>"from" 以一個<元素的陣列回傳 String"sender@example.com" li>"to" 返回包含聯絡資訊的兩個巢狀文件，作為GenericDocument兩個元素<的陣列 li>"to[1]" 返回第二個巢狀文件，包含 Marie Curie 的聯絡資訊，作為GenericDocument一個<元素的陣列 Li"to[1].email"<"curie@example.com"> 返回 Li"to[100].email">null，因為此文件陣列中"to"元素數量不多。 <LI>"to.email" 會將所有巢狀文件中的電子郵件聚合，並以 ["einstein@example.com", "curie@example.com"] 包含兩個元素的 String 陣列回傳。 </ul>

如果你知道所取得屬性的預期類型，建議改用此方法的類型版本，例如 #getPropertyString 或 #getPropertyStringArray。

如果該屬性是用 Builder#setProperty 其中一個函式指派為空陣列，這個方法會回傳一個空陣列。 若完全不存在此類性質，則此方法返回 null。

注意：若屬性為空 GenericDocument[] 或 byte[][]，此方法會在 之前android.os.Build.VERSION_CODES#TIRAMISU Android T的 Android 版本中回傳null一個值。 從 Android T 開始，如果屬性被設定為空陣列，且行為與其他屬性類型相符，則會回傳空陣列。

Java 文件 android.app.appsearch.GenericDocument.getProperty(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。