DocumentsContract 類別

定義

命名空間:

Android.Provider

組件:

Mono.Android.dll

定義文件提供者與平台之間的合約。

[Android.Runtime.Register("android/provider/DocumentsContract", DoNotGenerateAcw=true)]
public sealed class DocumentsContract : Java.Lang.Object

[<Android.Runtime.Register("android/provider/DocumentsContract", DoNotGenerateAcw=true)>]
type DocumentsContract = class
    inherit Object

繼承

Object

JavaObject

Object

DocumentsContract

屬性

RegisterAttribute

備註

定義文件提供者與平台之間的合約。

要建立文件提供者，擴展 DocumentsProvider，提供本契約的基礎實作。

所有用戶端應用程式必須持有有效的 URI 權限，才能存取文件，通常由使用者透過 、 Intent#ACTION_OPEN_DOCUMENT或 Intent#ACTION_CREATE_DOCUMENT進行選擇Intent#ACTION_OPEN_DOCUMENT_TREE時發出。

的 android.provider.DocumentsContractJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

欄位

名稱	Description
ActionDocumentSettings	當使用者希望在提供者應用程式中開啟/設定/管理特定文件時，DocumentsUI 所發出的意圖行動。
CategoryApprovedDocumentHandler	意圖類別用來篩選能處理文件意圖的活動。
ExtraError	目錄中包含 Cursor#getExtras() 一個可選字串，提供錯誤訊息，應向使用者顯示。
ExtraExcludeSelf	在 DocumentsUI 意向中設定此設定，使套件自身的根節點被排除在根節點清單之外。
ExtraInfo	目錄中包含 Cursor#getExtras() 可選字串，提供資訊訊息，應向使用者展示。
ExtraInitialUri	當顯示檔案選擇器時，會設定使用者可見的初始位置。
ExtraLoading	目錄中包含 Cursor#getExtras() 可選的布林標誌，表示文件提供者仍在載入資料。
ExtraOrientation	在解碼過程中，影像還需要多旋轉多少度數，才能正確呈現。
ExtraPrompt	當設定在意圖時，會覆蓋 DocumentsUI 預設的提示文字。
MetadataExif	使用 DocumentsContract#getDocumentMetadata 取得 Exif 資訊。
MetadataTreeCount	取得目前存放在指定目錄樹下所有文件的總數。
MetadataTreeSize	取得目前存放在指定目錄樹下所有文件的總大小。
MetadataTypes	Get 字串陣列會用 DocumentsContract#getDocumentMetadata 來識別回傳的類型或多種元資料。
ProviderInterface	意圖動作用於識別 DocumentsProvider 實例。
QueryArgDisplayName	查詢顯示名稱的鍵 DocumentsProvider 值會被匹配。
QueryArgExcludeMedia	用來 DocumentsProvider 決定是否應該排除已加入 MediaStore 的檔案。
QueryArgFileSizeOver	查詢檔案大小（位元組）的鍵 DocumentsProvider 值大於值。
QueryArgLastModifiedAfter	查詢最後修改時間的鍵 DocumentsProvider 值比值更新。
QueryArgMimeTypes	查詢 mime 類型的關鍵 DocumentsProvider 點是匹配的。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
JniPeerMembers	定義文件提供者與平台之間的合約。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
BuildChildDocumentsUri(String, String)	建立一個 URI，代表文件提供者中目標目錄的子節點。
BuildChildDocumentsUriUsingTree(Uri, String)	建立一個 URI，代表文件提供者中目標目錄的子節點。
BuildDocumentUri(String, String)	建立代表目標 Document#COLUMN_DOCUMENT_ID 的文件提供者的 URI。
BuildDocumentUriUsingTree(Uri, String)	建立代表目標 Document#COLUMN_DOCUMENT_ID 的文件提供者的 URI。
BuildRecentDocumentsUri(String, String)	建立 URI，代表文件提供者中特定根節點最近修改的文件。
BuildRootsUri(String)	建立代表文件提供者根源的 URI。
BuildRootUri(String, String)	建立一個以文件提供者表示所給內容 Root#COLUMN_ROOT_ID 的 URI。
BuildSearchDocumentsUri(String, String, String)	建立代表文件提供者中特定根節點下相符文件的搜尋 URI。
BuildSearchDocumentsUri(Uri, String)	建立 URI，代表在文件提供者特定目錄下搜尋相符文件。
BuildTrashDocumentsUri(String, String)	回傳代表特定文件提供者查詢垃圾檔文件的 URI。
BuildTreeDocumentUri(String, String)	建構 URI，表示存取給定 Document#COLUMN_DOCUMENT_ID後裔文件的權限。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
CopyDocument(ContentResolver, Uri, Uri)	複製給付的文件。
CreateDocument(ContentResolver, Uri, String, String)	建立一份新文件，使用指定的 MIME 類型和顯示名稱。
CreateWebLinkIntent(ContentResolver, Uri, Bundle)	建立取得該文件連結的意圖。
DeleteDocument(ContentResolver, Uri)	刪除給定的文件。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
EjectRoot(ContentResolver, Uri)	彈出給定根。
Equals(Object)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindDocumentPath(ContentResolver, Uri)	從文件樹頂端找到典範路徑。
GetDocumentId(Uri)	從給定的 URI 中提取 。Document#COLUMN_DOCUMENT_ID
GetDocumentMetadata(ContentResolver, Uri)	回傳與文件相關的元資料。
GetDocumentThumbnail(ContentResolver, Uri, Point, CancellationSignal)	回傳縮圖，代表該文件在指定 URI 的位置。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetRootId(Uri)	從給定的 URI 中提取 。Root#COLUMN_ROOT_ID
GetSearchDocumentsQuery(Uri)	從由 S #buildSearchDocumentsUri(String, String, String)建立的 URI 中擷取搜尋查詢。
GetTreeDocumentId(Uri)	從給定的 URI 中提取 via Document#COLUMN_DOCUMENT_ID
IsChildDocument(ContentResolver, Uri, Uri)	測試文件是否為該父母的後代（子女、孫輩等）。
IsDocumentUri(Context, Uri)	測試給定的 URI 是否代表 Document 一個由 DocumentsProvider。
IsRootsUri(Context, Uri)	測試給定的 URI 是否代表所有 DocumentsProvider由 支持的權威根。
IsRootUri(Context, Uri)	測試給定的 URI 是否代表特定根，並由 DocumentsProvider。
IsTreeUri(Uri)	測試給定的 URI 是否代表一棵 Document 樹。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
MoveDocument(ContentResolver, Uri, Uri, Uri)	將該文件移至新父文件之下。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
RemoveDocument(ContentResolver, Uri, Uri)	從父目錄中移除該文件。
RenameDocument(ContentResolver, Uri, String)	更改現有文件的顯示名稱。
RestoreDocumentFromTrash(ContentResolver, Uri, Uri)	從垃圾桶中還原文件。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
TrashDocument(ContentResolver, Uri)	把給定的文件丟掉。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	定義文件提供者與平台之間的合約。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	定義文件提供者與平台之間的合約。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。