Freigeben über


FileRandomAccessStream Klasse

Definition

Unterstützt das Lesen und Schreiben in eine Datei an einer angegebenen Position.

public ref class FileRandomAccessStream sealed : IClosable, IRandomAccessStream
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileRandomAccessStream final : IClosable, IRandomAccessStream
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileRandomAccessStream : System.IDisposable, IRandomAccessStream
Public NotInheritable Class FileRandomAccessStream
Implements IDisposable, IRandomAccessStream
Vererbung
Object Platform::Object IInspectable FileRandomAccessStream
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1709 16299 OpenAsync(String,FileAccessMode)
1709 16299 OpenAsync(String,FileAccessMode,StorageOpenOptions,FileOpenDisposition)
1709 16299 OpenForUserAsync(User,String,FileAccessMode)
1709 16299 OpenForUserAsync(User,String,FileAccessMode,StorageOpenOptions,FileOpenDisposition)
1709 16299 OpenTransactedWriteAsync(String)
1709 16299 OpenTransactedWriteAsync(String,StorageOpenOptions,FileOpenDisposition)
1709 16299 OpenTransactedWriteForUserAsync(User,String)
1709 16299 OpenTransactedWriteForUserAsync(User,String,StorageOpenOptions,FileOpenDisposition)

Eigenschaften

CanRead

Ruft einen Wert ab, der angibt, ob der Stream ausgelesen werden kann.

CanWrite

Ruft einen Wert ab, der angibt, ob die Datei geschrieben werden kann.

Position

Ruft den Byteoffset des Datenstroms ab.

Size

Ruft die Größe des Datenstroms für den zufälligen Zugriff ab oder legt sie fest.

Methoden

CloneStream()

Erstellt eine neue instance eines IRandomAccessStream über dieselbe Ressource wie der aktuelle Stream.

Close()

Schließt den aktuellen Stream und gibt Systemressourcen frei.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

FlushAsync()

Leert Daten asynchron in einem sequenziellen Stream.

GetInputStreamAt(UInt64)

Gibt einen Eingabedatenstrom an einer angegebenen Position in einem Datenstrom zurück.

GetOutputStreamAt(UInt64)

Gibt einen Ausgabedatenstrom an einer angegebenen Position in einem Datenstrom zurück.

OpenAsync(String, FileAccessMode)

Öffnet einen Stream für eine vorhandene Datei unter Angabe des Dateipfads.

OpenAsync(String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)

Öffnet einen Stream für eine Datei, die einen Dateipfad angegeben hat. Wenn die Datei nicht vorhanden ist, kann sie mit FileOpenDisposition erstellt werden.

OpenForUserAsync(User, String, FileAccessMode)

Öffnet einen Stream für einen Benutzer zu einer vorhandenen Datei unter Angabe des Dateipfads und der Benutzerinformationen.

OpenForUserAsync(User, String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)

Öffnet einen Datenstrom für einen Benutzer zu einer Datei mit einem Dateipfad und den Informationen des Benutzers. Wenn die Datei nicht vorhanden ist, kann sie mit FileOpenDisposition erstellt werden.

OpenTransactedWriteAsync(String)

Öffnet einen Stream zum Schreiben in eine vorhandene Datei unter Angabe des Dateipfads.

OpenTransactedWriteAsync(String, StorageOpenOptions, FileOpenDisposition)

Öffnet einen Stream zum Schreiben in eine Datei mit einem Dateipfad. Wenn die Datei nicht vorhanden ist, kann sie mit FileOpenDisposition erstellt werden.

OpenTransactedWriteForUserAsync(User, String)

Öffnet einen beschreibbaren Datenstrom für einen Benutzer in einer vorhandenen Datei unter Berücksichtigung des Dateipfads und der Benutzerinformationen.

OpenTransactedWriteForUserAsync(User, String, StorageOpenOptions, FileOpenDisposition)

Öffnet einen beschreibbaren Datenstrom für einen Benutzer in einer Datei mit einem Dateipfad und den Informationen des Benutzers. Wenn die Datei nicht vorhanden ist, kann sie mit FileOpenDisposition erstellt werden.

ReadAsync(IBuffer, UInt32, InputStreamOptions)

Gibt ein asynchrones Byteleseobjekt zurück.

Seek(UInt64)

Legt die Position des Datenstroms auf den angegebenen Wert fest.

WriteAsync(IBuffer)

Schreibt Daten asynchron in eine Datei.

Gilt für:

Weitere Informationen