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[]、 double[]、 boolean[]、 byte[][]、 GenericDocument[]のいずれかの型になります。

属性

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"は、1 つの要素を持つString配列として"sender@example.com"を返します <li>"to" 2 つの要素<li を持つGenericDocument配列として連絡先情報を含む 2 つの入れ子になったドキュメントを返します>"to[1]" 1 つの要素を持つGenericDocument配列としてマリー・キュリーの連絡先情報を含む 2 番目の入れ子になったドキュメント<li>"to[1].email"は"curie@example.com"<liを返します>"to[100].email"この特定のドキュメントは、その"to"配列に多くの要素を持っていないので、nullを返します。 <li>"to.email" は、入れ子になったすべてのドキュメントにわたって電子メールを集計し、2 つの要素を持つString配列として["einstein@example.com", "curie@example.com"]を返します。 </ul>

取得するプロパティの予想される型がわかっている場合は、代わりに、 #getPropertyString や #getPropertyStringArrayなど、このメソッドの型指定されたバージョンのいずれかを使用することをお勧めします。

プロパティが Builder#setProperty 関数のいずれかを使用して空の配列として割り当てられた場合、このメソッドは空の配列を返します。 このようなプロパティがまったく存在しない場合、このメソッドは nullを返します。

注: プロパティが空のGenericDocument[] またはbyte[][]の場合、このメソッドは、android.os.Build.VERSION_CODES#TIRAMISU Android Tより前のバージョンの Android でnull値を返します。 Android T 以降では、プロパティが空の配列として設定されている場合、他のプロパティ型の動作と一致する空の配列が返されます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。