ContentResolver.OpenFileDescriptor Método

Definición

Espacio de nombres:: Android.Content

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

Nombre	Description
OpenFileDescriptor(Uri, String)	Abra un descriptor de archivo sin formato para acceder a los datos en un URI.
OpenFileDescriptor(Uri, String, CancellationSignal)	Abra un descriptor de archivo sin formato para acceder a los datos en un URI.

OpenFileDescriptor(Uri, String)

Abra un descriptor de archivo sin formato para acceder a los datos en 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

Parámetros

uri: Uri

Identificador URI deseado que se va a abrir.

mode: String

Representación de cadena del modo de archivo. Puede ser "r", "w", "wt", "wa", "rw" o "rwt". Tenga en cuenta que la implementación exacta de estos puede diferir para cada implementación del proveedor; por ejemplo, "w" puede o no truncarse.

Devoluciones

ParcelFileDescriptor

Devuelve un nuevo Objeto ParcelFileDescriptor que apunta al archivo o null si el proveedor se bloqueó recientemente. Posee este descriptor y es responsable de cerrarlo cuando haya terminado.

Atributos: RegisterAttribute

Excepciones

FileNotFoundException

Produce FileNotFoundException si no existe ningún archivo en el URI o el modo no es válido.

Comentarios

Abra un descriptor de archivo sin formato para acceder a los datos en un URI. Esto es como #openAssetFileDescriptor(Uri, String), pero usa el método ContentProvider.openFile()} subyacente ContentProvider#openFile , por lo que <em>not</em> funcionará con proveedores que devuelven subsecciones de archivos. Si es posible, debe usar #openAssetFileDescriptor(Uri, String). Recibirá una excepción FileNotFoundException si el proveedor devuelve una subsección de un archivo.

<h5>Acepta los siguientes esquemas de URI:</h5><ul><li>content (#SCHEME_CONTENT)</li><li>file (#SCHEME_FILE)</li/li></ul>

Consulte #openAssetFileDescriptor(Uri, String) para obtener más información sobre estos esquemas.

Si se abre con los modos exclusivos "r" o "w", el objeto ParcelFileDescriptor devuelto podría ser un par de canalización o socket para habilitar el streaming de datos. La apertura con el modo "rw" implica un archivo en el disco que admite la búsqueda. Si es posible, use siempre un modo exclusivo para ofrecer la ContentProvider mayor flexibilidad posible.

Si está escribiendo un archivo y necesita comunicar un error al proveedor, use ParcelFileDescriptor#closeWithError(String).

Java documentación para android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Consulte también

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

Se aplica a

OpenFileDescriptor(Uri, String, CancellationSignal)