ContentResolver.OpenFileDescriptor Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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).
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).
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)>