FileRandomAccessStream Klasse

Referenz

Definition

Namespace:: Windows.Storage.Streams

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.

Bearbeiten

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: ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert: IClosable IDisposable IInputStream IOutputStream IRandomAccessStream

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: