ContentProvider.OpenTypedAssetFile Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| OpenTypedAssetFile(Uri, String, Bundle) |
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo MIME. |
| OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal) |
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo MIME. |
OpenTypedAssetFile(Uri, String, Bundle)
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo 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
Parametri
- uri
- Uri
Dati nel provider di contenuto su cui viene eseguito l'esecuzione di query.
- mimeTypeFilter
- String
Tipo di dati desiderati dal client. Può essere un modello, ad esempio /, se il chiamante non ha requisiti di tipo specifici; in questo caso il provider di contenuti sceglierà il tipo migliore corrispondente al modello.
- opts
- Bundle
Opzioni aggiuntive dal client. Le definizioni di queste sono specifiche per il provider di contenuti chiamato.
Valori restituiti
Restituisce un nuovo AssetFileDescriptor da cui il client può leggere i dati del tipo desiderato.
- Attributi
Eccezioni
Genera FileNotFoundException se non è presente alcun file associato all'URI specificato o la modalità non è valida.
Genera SecurityException se il chiamante non dispone dell'autorizzazione per accedere ai dati.
Genera IllegalArgumentException se il provider di contenuti non supporta il tipo MIME richiesto.
Commenti
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo MIME. Questo è simile #openAssetFile(Uri, String)a , ad eccezione del file può essere di sola lettura e il provider di contenuti può eseguire conversioni di dati per generare dati del tipo desiderato.
L'implementazione predefinita confronta il mimeType specificato con il risultato di #getType(Uri) e, se corrispondono, chiama #openAssetFile(Uri, String)semplicemente .
Vedere ClipData per esempi di utilizzo e implementazione di questo metodo.
AssetFileDescriptor restituito può essere una coppia pipe o socket per abilitare lo streaming dei dati.
Per una migliore interoperabilità con altre applicazioni, è consigliabile che per tutti gli URI che possono essere aperti, è anche possibile supportare query su di esse contenenti almeno le colonne specificate da android.provider.OpenableColumns. È anche possibile supportare altre colonne comuni se si dispone di metadati aggiuntivi da fornire, ad esempio android.provider.MediaStore.MediaColumns#DATE_ADDED in android.provider.MediaStore.MediaColumns.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Vedi anche
- <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)>
Si applica a
OpenTypedAssetFile(Uri, String, Bundle, CancellationSignal)
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo 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
Parametri
- uri
- Uri
Dati nel provider di contenuto su cui viene eseguito l'esecuzione di query.
- mimeTypeFilter
- String
Tipo di dati desiderati dal client. Può essere un modello, ad esempio /, se il chiamante non ha requisiti di tipo specifici; in questo caso il provider di contenuti sceglierà il tipo migliore corrispondente al modello.
- opts
- Bundle
Opzioni aggiuntive dal client. Le definizioni di queste sono specifiche per il provider di contenuti chiamato.
- signal
- CancellationSignal
Segnale per annullare l'operazione in corso o null in caso contrario. Ad esempio, se si scarica un file dalla rete per gestire una richiesta in modalità "rw", è necessario chiamare CancellationSignal#throwIfCanceled() periodicamente per verificare se il client ha annullato la richiesta e interrompere il download.
Valori restituiti
Restituisce un nuovo AssetFileDescriptor da cui il client può leggere i dati del tipo desiderato.
- Attributi
Eccezioni
Genera FileNotFoundException se non è presente alcun file associato all'URI specificato o la modalità non è valida.
Genera SecurityException se il chiamante non dispone dell'autorizzazione per accedere ai dati.
Genera IllegalArgumentException se il provider di contenuti non supporta il tipo MIME richiesto.
Commenti
Chiamato da un client per aprire un flusso di sola lettura contenente dati di un particolare tipo MIME. Questo è simile #openAssetFile(Uri, String)a , ad eccezione del file può essere di sola lettura e il provider di contenuti può eseguire conversioni di dati per generare dati del tipo desiderato.
L'implementazione predefinita confronta il mimeType specificato con il risultato di #getType(Uri) e, se corrispondono, chiama #openAssetFile(Uri, String)semplicemente .
Vedere ClipData per esempi di utilizzo e implementazione di questo metodo.
AssetFileDescriptor restituito può essere una coppia pipe o socket per abilitare lo streaming dei dati.
Per una migliore interoperabilità con altre applicazioni, è consigliabile che per tutti gli URI che possono essere aperti, è anche possibile supportare query su di esse contenenti almeno le colonne specificate da android.provider.OpenableColumns. È anche possibile supportare altre colonne comuni se si dispone di metadati aggiuntivi da fornire, ad esempio android.provider.MediaStore.MediaColumns#DATE_ADDED in android.provider.MediaStore.MediaColumns.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Vedi anche
- <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)>