ContentResolver.OpenAssetFileDescriptor 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
OpenAssetFileDescriptor(Uri, String) |
開啟源檔描述元,以存取 URI 底下的數據。 |
OpenAssetFileDescriptor(Uri, String, CancellationSignal) |
開啟源檔描述元,以存取 URI 底下的數據。 |
OpenAssetFileDescriptor(Uri, String)
開啟源檔描述元,以存取 URI 底下的數據。
[Android.Runtime.Register("openAssetFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/content/res/AssetFileDescriptor;", "")]
public Android.Content.Res.AssetFileDescriptor? OpenAssetFileDescriptor(Android.Net.Uri uri, string mode);
[<Android.Runtime.Register("openAssetFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/content/res/AssetFileDescriptor;", "")>]
member this.OpenAssetFileDescriptor : Android.Net.Uri * string -> Android.Content.Res.AssetFileDescriptor
參數
- uri
- Uri
要開啟的所需 URI。
- mode
- String
檔案模式的字串表示。 可以是 “r”、“w”、“wt”、“wa”、“rw” 或 “rwt”。 請注意,每個提供者實作的確切實作可能會有所不同,例如,“w” 可能會或可能不會截斷。
傳回
傳回指向檔案的新 ParcelFileDescriptor,或 null
提供者最近當機時。 您擁有此描述元,並在完成時負責關閉它。
- 屬性
例外狀況
擲回 URI 下不存在檔案的 FileNotFoundException,或模式無效。
備註
開啟源檔描述元,以存取 URI 底下的數據。 這會與與指定 URI 相關聯之提供者的基礎 ContentProvider#openAssetFile
方法互動,以擷取儲存在那裡的任何檔案。
<h5>接受下列 URI 配置:</h5><ul<>li>content (#SCHEME_CONTENT
)/li li><>android.resource (#SCHEME_ANDROID_RESOURCE
)</li li>file ()<</li>><</ul<>h5>Android.resource (#SCHEME_FILE
#SCHEME_ANDROID_RESOURCE
) Scheme</h5>
Uri 對象可用來參考 APK 檔案中的資源。 URI 應該是下列其中一種格式:<ul<>li>android.resource://package_name/id_number
<br/>package_name
是您的套件名稱,如AndroidManifest.xml所示。 例如 com.example.myapp
<br/>id_number
是識別碼的 int 形式。<br/> 建構此表單最簡單的方式是
Uri uri = Uri.parse("android.resource://com.example.myapp/" + R.raw.my_resource");
</li li><><android.resource://package_name/type/name
br/>package_name
是您AndroidManifest.xml中列出的套件名稱。 例如 com.example.myapp
<br/>type
是資源類型的字串形式。 例如,raw
或 drawable
。 name
是資源名稱的字串形式。 也就是說,無論您的檔名位於 res 目錄中,都沒有類型擴展名。 建構此窗體最簡單的方式是
Uri uri = Uri.parse("android.resource://com.example.myapp/raw/my_resource");
</li></ul>
請注意,如果針對內容上的只讀輸入呼叫此函式(模式為 “r”),則會改為使用MIME類型 “*/*” 呼叫 #openTypedAssetFileDescriptor
。 這可讓這類呼叫端受益於提供者實作的任何內建數據轉換。
的 android.content.ContentResolver.openAssetFileDescriptor(android.net.Uri, java.lang.String)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
OpenAssetFileDescriptor(Uri, String, CancellationSignal)
開啟源檔描述元,以存取 URI 底下的數據。
[Android.Runtime.Register("openAssetFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/content/res/AssetFileDescriptor;", "")]
public Android.Content.Res.AssetFileDescriptor? OpenAssetFileDescriptor(Android.Net.Uri uri, string mode, Android.OS.CancellationSignal? cancellationSignal);
[<Android.Runtime.Register("openAssetFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/content/res/AssetFileDescriptor;", "")>]
member this.OpenAssetFileDescriptor : Android.Net.Uri * string * Android.OS.CancellationSignal -> Android.Content.Res.AssetFileDescriptor
參數
- uri
- Uri
要開啟的所需 URI。
- mode
- String
檔案模式的字串表示。 可以是 “r”、“w”、“wt”、“wa”、“rw” 或 “rwt”。 請注意,“w” 只會寫入,而 “wt” 是寫入和截斷。
如需詳細資訊,請參閱 ParcelFileDescriptor#parseMode
。
- cancellationSignal
- CancellationSignal
取消進行中作業的訊號,如果沒有則為 null。 勾選作業, OperationCanceledException
則會擲回 。
傳回
傳回指向檔案的新 ParcelFileDescriptor,或 null
提供者最近當機時。 您擁有此描述元,並在完成時負責關閉它。
- 屬性
例外狀況
擲回 URI 下不存在檔案的 FileNotFoundException,或模式無效。
備註
開啟源檔描述元,以存取 URI 底下的數據。 這會與與指定 URI 相關聯之提供者的基礎 ContentProvider#openAssetFile
方法互動,以擷取儲存在那裡的任何檔案。
<h5>接受下列 URI 配置:</h5><ul<>li>content (#SCHEME_CONTENT
)/li li><>android.resource (#SCHEME_ANDROID_RESOURCE
)</li li>file ()<</li>><</ul<>h5>Android.resource (#SCHEME_FILE
#SCHEME_ANDROID_RESOURCE
) Scheme</h5>
Uri 對象可用來參考 APK 檔案中的資源。 URI 應該是下列其中一種格式:<ul<>li>android.resource://package_name/id_number
<br/>package_name
是您的套件名稱,如AndroidManifest.xml所示。 例如 com.example.myapp
<br/>id_number
是識別碼的 int 形式。<br/> 建構此表單最簡單的方式是
Uri uri = Uri.parse("android.resource://com.example.myapp/" + R.raw.my_resource");
</li li><><android.resource://package_name/type/name
br/>package_name
是您AndroidManifest.xml中列出的套件名稱。 例如 com.example.myapp
<br/>type
是資源類型的字串形式。 例如,raw
或 drawable
。 name
是資源名稱的字串形式。 也就是說,無論您的檔名位於 res 目錄中,都沒有類型擴展名。 建構此窗體最簡單的方式是
Uri uri = Uri.parse("android.resource://com.example.myapp/raw/my_resource");
</li></ul>
請注意,如果針對內容上的只讀輸入呼叫此函式(模式為 “r”),則會改為使用MIME類型 “*/*” 呼叫 #openTypedAssetFileDescriptor
。 這可讓這類呼叫端受益於提供者實作的任何內建數據轉換。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。