DocumentsProvider.QueryChildDocuments 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| QueryChildDocuments(String, String[], Bundle) |
覆寫此方法以返回所請求目錄中包含的子文件。 |
| QueryChildDocuments(String, String[], String) |
返回所請求目錄中包含的子文件。 |
QueryChildDocuments(String, String[], Bundle)
覆寫此方法以返回所請求目錄中包含的子文件。
[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)]
public virtual Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, Android.OS.Bundle? queryArgs);[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)>]
abstract member QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor
override this.QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor參數
- parentDocumentId
- String
退還兒童的目錄。
- projection
- String[]
列入游標的清單 Document 。 是否 null 應該包含所有支持的欄位。
- queryArgs
- Bundle
包含排序資訊或其他對提供者有用的參數的套件。 若無排序資訊，則會使用預設排序方式，且可能為無序排序。 如需詳細資訊，請參閱 ContentResolver#QUERY_ARG_SORT_COLUMNS。
傳回
- 屬性
備註
覆寫此方法以返回所請求目錄中包含的子文件。 此規定必須僅傳達直系後代。
如果你的服務提供者是雲端的，且你有本地快取資料，你可以立即回傳本地資料，並設定 DocumentsContract#EXTRA_LOADING 游標額外值表示你仍在取得更多資料。 然後，當網路資料可用時，你可以發送變更通知，觸發重新查詢並回傳完整內容。 要返回帶有額外參數的游標，你需要延長並覆寫 Cursor#getExtras()。
要支援變更通知，您必須 Cursor#setNotificationUri(ContentResolver, Uri) 使用相關的 Uri，例如 DocumentsContract#buildChildDocumentsUri(String, String)。 然後你可以用那個 Uri 打電話 ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) 發送變更通知。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
QueryChildDocuments(String, String[], String)
返回所請求目錄中包含的子文件。
[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")]
public abstract Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, string? sortOrder);[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")>]
abstract member QueryChildDocuments : string * string[] * string -> Android.Database.ICursor參數
- parentDocumentId
- String
退還兒童的目錄。
- projection
- String[]
列入游標的清單 Document 。 是否 null 應該包含所有支持的欄位。
- sortOrder
- String
如何排序列，格式化為 SQL ORDER BY 子句（不含 ORDER BY 本身）。
傳遞 null 時會使用預設的排序順序，該排序順序可能是無序的。 這個排序是一個提示，可以用來優先排序從網路擷取資料的方式，但 UI 可能總是強制執行特定的排序。
傳回
- 屬性
例外狀況
備註
返回所請求目錄中包含的子文件。 此方法必須只回傳直系後代，因為還會發出額外查詢以遞迴探索樹狀結構。
目標 android.os.Build.VERSION_CODES#O 鎖定或更高等級的應用程式應該會覆蓋 #queryChildDocuments(String, String[], Bundle)。
如果你的服務提供者是雲端的，且你有部分資料在本地快取或釘選，你可以立即回傳本地資料，並在游標上設定 DocumentsContract#EXTRA_LOADING 你仍在取得額外資料。 然後，當網路資料可用時，你可以發送變更通知，觸發重新查詢並回傳完整內容。 要返回帶有額外參數的游標，你需要延長並覆寫 Cursor#getExtras()。
要支援變更通知，您必須 Cursor#setNotificationUri(ContentResolver, Uri) 使用相關的 Uri，例如 DocumentsContract#buildChildDocumentsUri(String, String)。 然後你可以用那個 Uri 打電話 ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) 發送變更通知。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。