ContentResolver.OpenFileDescriptor Methode

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
OpenFileDescriptor(Uri, String)	Öffnen Sie einen Unformatierten Dateideskriptor, um auf Daten unter einem URI zuzugreifen.
OpenFileDescriptor(Uri, String, CancellationSignal)	Öffnen Sie einen Unformatierten Dateideskriptor, um auf Daten unter einem URI zuzugreifen.

OpenFileDescriptor(Uri, String)

Öffnen Sie einen Unformatierten Dateideskriptor, um auf Daten unter einem URI zuzugreifen.

[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

Der gewünschte URI, der geöffnet werden soll.

mode: String

Die Zeichenfolgendarstellung des Dateimodus. Kann "r", "w", "wt", "wa", "rw" oder "rwt" sein. Bitte beachten Sie, dass sich die genaue Implementierung für jede Anbieterimplementierung unterscheiden kann – z. B. "w" kann oder nicht abgeschnitten werden.

Gibt zurück

ParcelFileDescriptor

Gibt einen neuen ParcelFileDescriptor zurück, der auf die Datei zeigt oder null wenn der Anbieter kürzlich abgestürzt ist. Sie besitzen diesen Deskriptor und sind dafür verantwortlich, sie zu schließen, wenn Sie fertig sind.

Attribute: RegisterAttribute

Ausnahmen

FileNotFoundException

Löst FileNotFoundException aus, wenn keine Datei unter dem URI vorhanden ist oder der Modus ungültig ist.

Hinweise

Öffnen Sie einen Unformatierten Dateideskriptor, um auf Daten unter einem URI zuzugreifen. Dies ist ähnlich#openAssetFileDescriptor(Uri, String), verwendet aber die zugrunde liegende ContentProvider#openFile ContentProvider.openFile()}-Methode. Daher funktionieren <>nicht</em> mit Anbietern, die Unterabschnitte von Dateien zurückgeben. Wenn möglich, sollten Sie .#openAssetFileDescriptor(Uri, String) Sie erhalten eine FileNotFoundException-Ausnahme, wenn der Anbieter einen Unterabschnitt einer Datei zurückgibt.

<h5>Akzeptiert die folgenden URI-Schemas:</h5><ul><li>content (#SCHEME_CONTENT)</li li><>file (#SCHEME_FILE)</li/ul><>

Weitere Informationen zu diesen Schemas finden Sie #openAssetFileDescriptor(Uri, String) unter.

Wenn sie mit dem exklusiven Modus "r" oder "w" geöffnet werden, kann der zurückgegebene PaketFileDescriptor ein Pipe- oder Socketpaar sein, um das Streamen von Daten zu ermöglichen. Das Öffnen mit dem "rw"-Modus impliziert eine Datei auf dem Datenträger, die die Suche unterstützt. Wenn möglich, verwenden Sie immer einen exklusiven Modus, um dem zugrunde liegenden ContentProvider Flexibilität zu verleihen.

Wenn Sie eine Datei schreiben und einen Fehler an den Anbieter übermitteln müssen, verwenden Sie ParcelFileDescriptor#closeWithError(String).

Java Dokumentation für android.content.ContentResolver.openFileDescriptor(android.net.Uri, java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Weitere Informationen

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

Gilt für:

OpenFileDescriptor(Uri, String, CancellationSignal)