ContentResolver.OpenFileDescriptor Metode

Definisi

Overload

Nama Deskripsi
OpenFileDescriptor(Uri, String)

Buka pendeskripsi file mentah untuk mengakses data di bawah URI.

OpenFileDescriptor(Uri, String, CancellationSignal)

Buka pendeskripsi file mentah untuk mengakses data di bawah URI.

OpenFileDescriptor(Uri, String)

Buka pendeskripsi file mentah untuk mengakses data di bawah 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

Parameter

uri
Uri

URI yang diinginkan untuk dibuka.

mode
String

Representasi string dari mode file. Bisa "r", "w", "wt", "wa", "rw" atau "rwt". Harap dicatat bahwa implementasi yang tepat dari ini mungkin berbeda untuk setiap implementasi Penyedia - misalnya, "w" mungkin atau mungkin tidak terpotong.

Mengembalikan

Mengembalikan ParcelFileDescriptor baru yang menunjuk ke file atau null jika penyedia baru-baru ini mengalami crash. Anda memiliki deskriptor ini dan bertanggung jawab untuk menutupnya setelah selesai.

Atribut

Pengecualian

Melempar FileNotFoundException jika tidak ada file di bawah URI atau mode tidak valid.

Keterangan

Buka pendeskripsi file mentah untuk mengakses data di bawah URI. Ini seperti #openAssetFileDescriptor(Uri, String), tetapi menggunakan metode ContentProvider.openFile()} yang mendasarContentProvider#openFile, jadi apakah mereka<tidak> akan <> bekerja dengan penyedia yang mengembalikan sub-bagian file. Jika memungkinkan, Anda harus menggunakan #openAssetFileDescriptor(Uri, String). Anda akan menerima pengecualian FileNotFoundException jika penyedia mengembalikan sub-bagian file.

<h5>Menerima skema URI berikut:</h5><konten ul><li>(#SCHEME_CONTENT)</li><li>file (#SCHEME_FILE)</li></ul>

Lihat #openAssetFileDescriptor(Uri, String) untuk informasi selengkapnya tentang skema ini.

Jika dibuka dengan mode "r" atau "w" eksklusif, ParcelFileDescriptor yang dikembalikan bisa menjadi pasangan pipa atau soket untuk mengaktifkan streaming data. Membuka dengan mode "rw" menyiratkan file pada disk yang mendukung pencarian. Jika memungkinkan, selalu gunakan mode eksklusif untuk memberikan fleksibilitas paling mendasar ContentProvider .

Jika Anda menulis file, dan perlu mengomunikasikan kesalahan kepada penyedia, gunakan ParcelFileDescriptor#closeWithError(String).

Java dokumentasi untuk android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String).

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Lihat juga

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

Berlaku untuk

OpenFileDescriptor(Uri, String, CancellationSignal)

Buka pendeskripsi file mentah untuk mengakses data di bawah URI.

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

Parameter

uri
Uri

URI yang diinginkan untuk dibuka.

mode
String

Representasi string dari mode file. Bisa "r", "w", "wt", "wa", "rw" atau "rwt". Harap dicatat bahwa implementasi yang tepat dari ini mungkin berbeda untuk setiap implementasi Penyedia - misalnya, "w" mungkin atau mungkin tidak terpotong.

cancellationSignal
CancellationSignal

Sinyal untuk membatalkan operasi yang sedang berlangsung, atau null jika tidak ada. Jika operasi dibatalkan, maka OperationCanceledException akan dilemparkan.

Mengembalikan

Mengembalikan ParcelFileDescriptor baru yang menunjuk ke file atau null jika penyedia baru-baru ini mengalami crash. Anda memiliki deskriptor ini dan bertanggung jawab untuk menutupnya setelah selesai.

Atribut

Pengecualian

Melempar FileNotFoundException jika tidak ada file di bawah URI atau mode tidak valid.

Keterangan

Buka pendeskripsi file mentah untuk mengakses data di bawah URI. Ini seperti #openAssetFileDescriptor(Uri, String), tetapi menggunakan metode ContentProvider.openFile()} yang mendasarContentProvider#openFile, jadi apakah mereka<tidak> akan <> bekerja dengan penyedia yang mengembalikan sub-bagian file. Jika memungkinkan, Anda harus menggunakan #openAssetFileDescriptor(Uri, String). Anda akan menerima pengecualian FileNotFoundException jika penyedia mengembalikan sub-bagian file.

<h5>Menerima skema URI berikut:</h5><konten ul><li>(#SCHEME_CONTENT)</li><li>file (#SCHEME_FILE)</li></ul>

Lihat #openAssetFileDescriptor(Uri, String) untuk informasi selengkapnya tentang skema ini.

Jika dibuka dengan mode "r" atau "w" eksklusif, ParcelFileDescriptor yang dikembalikan bisa menjadi pasangan pipa atau soket untuk mengaktifkan streaming data. Membuka dengan mode "rw" menyiratkan file pada disk yang mendukung pencarian. Jika memungkinkan, selalu gunakan mode eksklusif untuk memberikan fleksibilitas paling mendasar ContentProvider .

Jika Anda menulis file, dan perlu mengomunikasikan kesalahan kepada penyedia, gunakan ParcelFileDescriptor#closeWithError(String).

Java dokumentasi untuk android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String, android.os.CancellationSignal).

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Lihat juga

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

Berlaku untuk