FileIO Class

Stellt Hilfsmethoden zum Lesen und Schreiben von Dateien bereit, die von Objekten des Typs IStorageFile dargestellt werden.

Syntax


var fileIO = Windows.Storage.FileIO;

Attribute

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Member

Der FileIOKlasse hat die folgenden Arten von Membern:

Methoden

The FileIO Klasse verfügt über die folgenden Methoden. Mit C#, Visual Basic und C++ erbt er außerdem Methoden von Object Klasse.

MethodeBeschreibung
AppendLinesAsync(IStorageFile, IIterable(String)) Appends lines of text to the specified file.
AppendLinesAsync(IStorageFile, IIterable(String), UnicodeEncoding) Appends lines of text to the specified file using the specified character encoding.
AppendTextAsync(IStorageFile, String) Appends text to the specified file.
AppendTextAsync(IStorageFile, String, UnicodeEncoding) Appends text to the specified file using the specified character encoding.
ReadBufferAsync Reads the contents of the specified file and returns a buffer.
ReadLinesAsync(IStorageFile) Reads the contents of the specified file and returns lines of text.
ReadLinesAsync(IStorageFile, UnicodeEncoding) Reads the contents of the specified file using the specified character encoding and returns lines of text.
ReadTextAsync(IStorageFile) Reads the contents of the specified file and returns text.
ReadTextAsync(IStorageFile, UnicodeEncoding) Reads the contents of the specified file using the specified character encoding and returns text.
WriteBufferAsync Writes data from a buffer to the specified file.
WriteBytesAsync Writes an array of bytes of data to the specified file.
WriteLinesAsync(IStorageFile, IIterable(String)) Writes lines of text to the specified file.
WriteLinesAsync(IStorageFile, IIterable(String), UnicodeEncoding) Writes lines of text to the specified file using the specified character encoding.
WriteTextAsync(IStorageFile, String) Writes text to the specified file.
WriteTextAsync(IStorageFile, String, UnicodeEncoding) Writes text to the specified file using the specified character encoding.

 

Anmerkungen

Diese Klasse ist statisch und kann nicht instanziiert werden. Rufen Sie die Methoden stattdessen direkt auf.

Weitere Informationen über die für die App verfügbaren Speicherorte finden Sie unter Dateizugriff und Berechtigungen in Windows Store-Apps.

Informationen zum Lesen und Schreiben von Dateien finden Sie unter Schnellstart: Lesen und Schreiben von Dateien.

Beispiele

Im Dateizugriffsbeispiel wird erläutert, wie writeTextAsync(file, contents) verwendet wird, um Text in eine Datei zu schreiben.



if (file !== null) {
    Windows.Storage.FileIO.writeTextAsync(file, "Swift as a shadow").done(function () {
        // Perform additional tasks after file is written
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during write
    });
}

Im Beispiel ist file eine lokale Variable, die storageFile enthält, welche die Datei darstellt, in die geschrieben werden soll.

Obwohl die writeTextAsync-Methoden keinen Rückgabewert aufweisen, können Sie weiterhin zusätzliche Aufgaben ausführen, nachdem der Text in die Datei geschrieben wurde, wie das Beispiel verdeutlicht.

Das Dateizugriffsbeispiel zeigt auch, wie readTextAsync(file) verwendet wird, um Text aus einer Datei zu lesen.


if (file !== null) {
    Windows.Storage.FileIO.readTextAsync(file).done(function (fileContent) {
        // Process content read from the file
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during read
    });
}

Im Beispiel ist file eine lokale Variable, die eine storageFile enthält, welche die Datei darstellt, für gelesen werden sollen.

Nach Abschließen von readTextAsync ruft die fileContent-Variable den Inhalt der Datei als Textzeichenfolge ab. Sie können den Inhalt dann nach Bedarf verarbeiten.

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8 [Nur Windows Store-Apps]

Unterstützte Mindestversion (Server)

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

 

 

Anzeigen:
© 2014 Microsoft