ContentResolver.OpenFileDescriptor Méthode

Définition

Espace de noms:: Android.Content

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
OpenFileDescriptor(Uri, String)	Ouvrez un descripteur de fichier brut pour accéder aux données sous un URI.
OpenFileDescriptor(Uri, String, CancellationSignal)	Ouvrez un descripteur de fichier brut pour accéder aux données sous un URI.

OpenFileDescriptor(Uri, String)

Ouvrez un descripteur de fichier brut pour accéder aux données sous un URI.

[Android.Runtime.Register("openFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/os/ParcelFileDescriptor;", "")]
public Android.OS.ParcelFileDescriptor? OpenFileDescriptor(Android.Net.Uri uri, string mode);

[<Android.Runtime.Register("openFileDescriptor", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/os/ParcelFileDescriptor;", "")>]
member this.OpenFileDescriptor : Android.Net.Uri * string -> Android.OS.ParcelFileDescriptor

Paramètres

uri: Uri

URI souhaité à ouvrir.

mode: String

Représentation sous forme de chaîne du mode fichier. Peut être « r », « w », « wt », « wa », « rw » ou « rwt ». Notez que l’implémentation exacte de ces éléments peut différer pour chaque implémentation de fournisseur , par exemple, « w » peut ou ne pas tronquer.

Retours

ParcelFileDescriptor

Retourne un nouveau ParcelFileDescriptor pointant vers le fichier ou null si le fournisseur a récemment bloqué. Vous êtes propriétaire de ce descripteur et êtes responsable de la fermer quand vous avez terminé.

Attributs: RegisterAttribute

Exceptions

FileNotFoundException

Lève FileNotFoundException si aucun fichier n’existe sous l’URI ou si le mode n’est pas valide.

Remarques

Ouvrez un descripteur de fichier brut pour accéder aux données sous un URI. Cela est semblable #openAssetFileDescriptor(Uri, String), mais utilise la méthode ContentProvider.openFile()}sous-jacente ContentProvider#openFile . Par conséquent <, em>ne fonctionne pas</em> avec les fournisseurs qui retournent des sous-sections de fichiers. Si possible, vous devez utiliser #openAssetFileDescriptor(Uri, String). Vous recevrez une exception FileNotFoundException si le fournisseur retourne une sous-section d’un fichier.

<h5>Accepte les schémas d’URI suivants :</h5><ul><li>content (#SCHEME_CONTENT)</li li><>file (#SCHEME_FILE)</li></ul>

Consultez #openAssetFileDescriptor(Uri, String) pour plus d’informations sur ces schémas.

Si vous ouvrez avec les modes exclusifs « r » ou « w », le ColisFileDescriptor retourné peut être une paire de canal ou de socket pour activer la diffusion en continu de données. L’ouverture avec le mode « rw » implique un fichier sur le disque qui prend en charge la recherche. Si possible, utilisez toujours un mode exclusif pour offrir la plus grande flexibilité sous-jacente ContentProvider .

Si vous écrivez un fichier et que vous devez communiquer une erreur au fournisseur, utilisez ParcelFileDescriptor#closeWithError(String).

Java documentation pour android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Voir aussi

<xref:Android.Content.ContentResolver.OpenAssetFileDescriptor(Android.Net.Uri%2c+System.String)>

S’applique à

OpenFileDescriptor(Uri, String, CancellationSignal)