ContentProvider.OpenTypedAssetFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
OpenTypedAssetFile(Uri, String, Bundle) |
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。 |
OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal) |
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。 |
OpenTypedAssetFile(Uri, String, Bundle)
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。
[Android.Runtime.Register("openTypedAssetFile", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/Bundle;)Landroid/content/res/AssetFileDescriptor;", "GetOpenTypedAssetFile_Landroid_net_Uri_Ljava_lang_String_Landroid_os_Bundle_Handler")]
public virtual Android.Content.Res.AssetFileDescriptor? OpenTypedAssetFile (Android.Net.Uri uri, string mimeTypeFilter, Android.OS.Bundle? opts);
[<Android.Runtime.Register("openTypedAssetFile", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/Bundle;)Landroid/content/res/AssetFileDescriptor;", "GetOpenTypedAssetFile_Landroid_net_Uri_Ljava_lang_String_Landroid_os_Bundle_Handler")>]
abstract member OpenTypedAssetFile : Android.Net.Uri * string * Android.OS.Bundle -> Android.Content.Res.AssetFileDescriptor
override this.OpenTypedAssetFile : Android.Net.Uri * string * Android.OS.Bundle -> Android.Content.Res.AssetFileDescriptor
パラメーター
- uri
- Uri
クエリ対象のコンテンツ プロバイダー内のデータ。
- mimeTypeFilter
- String
クライアントが必要なデータの種類。 呼び出し元に特定 の 型要件がない場合は、/などのパターンを使用できます。この場合、コンテンツ プロバイダーは、パターンに一致する最適な種類を選択します。
- opts
- Bundle
クライアントからの追加オプション。 これらの定義は、呼び出されるコンテンツ プロバイダーに固有です。
戻り値
クライアントが目的の型のデータを読み取ることができる新しい AssetFileDescriptor を返します。
- 属性
例外
指定された URI に関連付けられているファイルがない場合、またはモードが無効な場合は、FileNotFoundException をスローします。
呼び出し元にデータへのアクセス許可がない場合は、SecurityException をスローします。
コンテンツ プロバイダーが要求された MIME の種類をサポートしていない場合は、IllegalArgumentException をスローします。
注釈
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。 これは と似ています #openAssetFile(Uri, String)
が、ファイルを読み取り専用にすることや、コンテンツ プロバイダーがデータ変換を実行して目的の種類のデータを生成する場合を除きます。
既定の実装では、指定された mimeType を の #getType(Uri)
結果と比較し、一致する場合は 単に を呼び出します #openAssetFile(Uri, String)
。
このメソッドの使用と実装の例を参照してください ClipData
。
返される AssetFileDescriptor には、データのストリーミングを有効にするパイプまたはソケットのペアを指定できます。
<p class="note">他のアプリケーションとの相互運用性を高めるには、開くことができるすべての URI に対して、 で android.provider.OpenableColumns
指定された列を少なくとも含むクエリもサポートすることをお勧めします。 など、追加のメタデータを指定する場合は、android.provider.MediaStore.MediaColumns#DATE_ADDED
android.provider.MediaStore.MediaColumns
他の一般的な列をサポートすることもできます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
- <xref:Android.Content.ContentProvider.GetStreamTypes(Android.Net.Uri%2c+System.String)>
- <xref:Android.Content.ContentProvider.OpenAssetFile(Android.Net.Uri%2c+System.String)>
- <xref:Android.Content.ClipDescription.CompareMimeTypes(System.String%2c+System.String)>
適用対象
OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal)
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。
[Android.Runtime.Register("openTypedAssetFile", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/content/res/AssetFileDescriptor;", "GetOpenTypedAssetFile_Landroid_net_Uri_Ljava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler")]
public virtual Android.Content.Res.AssetFileDescriptor? OpenTypedAssetFile (Android.Net.Uri uri, string mimeTypeFilter, Android.OS.Bundle? opts, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("openTypedAssetFile", "(Landroid/net/Uri;Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/content/res/AssetFileDescriptor;", "GetOpenTypedAssetFile_Landroid_net_Uri_Ljava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler")>]
abstract member OpenTypedAssetFile : Android.Net.Uri * string * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Content.Res.AssetFileDescriptor
override this.OpenTypedAssetFile : Android.Net.Uri * string * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Content.Res.AssetFileDescriptor
パラメーター
- uri
- Uri
クエリ対象のコンテンツ プロバイダー内のデータ。
- mimeTypeFilter
- String
クライアントが必要なデータの種類。 呼び出し元に特定 の 型要件がない場合は、/などのパターンを使用できます。この場合、コンテンツ プロバイダーは、パターンに一致する最適な種類を選択します。
- opts
- Bundle
クライアントからの追加オプション。 これらの定義は、呼び出されるコンテンツ プロバイダーに固有です。
- signal
- CancellationSignal
進行中の操作を取り消すシグナル。 null
存在しない場合は 。 たとえば、"rw" モード要求を処理するためにネットワークからファイルをダウンロードする場合は、クライアントが要求を取り消したかどうかをチェックを定期的に呼び出CancellationSignal#throwIfCanceled()
し、ダウンロードを中止する必要があります。
戻り値
クライアントが目的の型のデータを読み取ることができる新しい AssetFileDescriptor を返します。
- 属性
例外
指定された URI に関連付けられているファイルがない場合、またはモードが無効な場合は、FileNotFoundException をスローします。
呼び出し元にデータへのアクセス許可がない場合は、SecurityException をスローします。
コンテンツ プロバイダーが要求された MIME の種類をサポートしていない場合は、IllegalArgumentException をスローします。
注釈
クライアントによって呼び出され、特定の MIME の種類のデータを含む読み取り専用ストリームを開きます。 これは と似ています #openAssetFile(Uri, String)
が、ファイルを読み取り専用にすることや、コンテンツ プロバイダーがデータ変換を実行して目的の種類のデータを生成する場合を除きます。
既定の実装では、指定された mimeType を の #getType(Uri)
結果と比較し、一致する場合は 単に を呼び出します #openAssetFile(Uri, String)
。
このメソッドの使用と実装の例を参照してください ClipData
。
返される AssetFileDescriptor には、データのストリーミングを有効にするパイプまたはソケットのペアを指定できます。
<p class="note">他のアプリケーションとの相互運用性を高めるには、開くことができるすべての URI に対して、 で android.provider.OpenableColumns
指定された列を少なくとも含むクエリもサポートすることをお勧めします。 など、追加のメタデータを指定する場合は、android.provider.MediaStore.MediaColumns#DATE_ADDED
android.provider.MediaStore.MediaColumns
他の一般的な列をサポートすることもできます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
- <xref:Android.Content.ContentProvider.GetStreamTypes(Android.Net.Uri%2c+System.String)>
- <xref:Android.Content.ContentProvider.OpenAssetFile(Android.Net.Uri%2c+System.String)>
- <xref:Android.Content.ClipDescription.CompareMimeTypes(System.String%2c+System.String)>