FileIO Klasse

Definition

Namespace:

Windows.Storage

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

public ref class FileIO abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FileIO final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class FileIO

Public Class FileIO

Vererbung

Object Platform::Object IInspectable FileIO

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

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

Beispiele

Im Dateizugriffsbeispiel wird gezeigt, wie Sie WriteTextAsync(file, contents) verwenden, um Text in eine Datei zu schreiben.

try
{
    if (file != null)
    {
        await FileIO.WriteTextAsync(file, "Swift as a shadow");
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        co_await FileIO::WriteTextAsync(file, L"Swift as a shadow");
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Im Beispiel ist eine lokale Variable, file die eine StorageFile-Datei enthält, die die zu schreibende Datei darstellt.

Obwohl die WriteTextAsync-Methoden keinen Rückgabewert haben, können Sie dennoch zusätzliche Aufgaben ausführen, nachdem der Text in die Datei geschrieben wurde, wie im Beispiel gezeigt. Im Dateizugriffsbeispiel wird außerdem gezeigt, wie Sie ReadTextAsync(file) verwenden, um Text aus einer Datei zu lesen.

try
{
    if (file != null)
    {
        string fileContent = await FileIO.ReadTextAsync(file);
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        hstring fileContent = co_await FileIO::ReadTextAsync(file);
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Im Beispiel ist eine lokale Variable, file die eine StorageFile-Datei enthält, die die zu lesende Datei darstellt.

Nach Abschluss von ReadTextAsync ruft die fileContent Variable den Inhalt der Datei als Textzeichenfolge ab. Anschließend können Sie den Inhalt entsprechend verarbeiten.

Hinweise

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

Weitere Informationen zu den Speicherorten, auf die Ihre App zugreifen kann, finden Sie unter Dateizugriffsberechtigungen.

Informationen zum Lesen und Schreiben in Dateien finden Sie unter Erstellen, Schreiben und Lesen einer Datei.

Methoden

AppendLinesAsync(IStorageFile, IIterable<String>)	Fügt Textzeilen an die angegebene Datei an.
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Fügt Textzeilen mithilfe der angegebenen Zeichencodierung an die angegebene Datei an.
AppendTextAsync(IStorageFile, String)	Fügt Text an die angegebene Datei an.
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	Fügt Text mithilfe der angegebenen Zeichencodierung an die angegebene Datei an.
ReadBufferAsync(IStorageFile)	Liest den Inhalt der angegebenen Datei und gibt einen Puffer zurück.
ReadLinesAsync(IStorageFile)	Liest den Inhalt der angegebenen Datei und gibt Textzeilen zurück.
ReadLinesAsync(IStorageFile, UnicodeEncoding)	Liest den Inhalt der angegebenen Datei mithilfe der angegebenen Zeichencodierung und gibt Textzeilen zurück.
ReadTextAsync(IStorageFile)	Liest den Inhalt der angegebenen Datei und gibt Text zurück.
ReadTextAsync(IStorageFile, UnicodeEncoding)	Liest den Inhalt der angegebenen Datei mit der angegebenen Zeichencodierung und gibt Text zurück.
WriteBufferAsync(IStorageFile, IBuffer)	Schreibt Daten aus einem Puffer in die angegebene Datei.
WriteBytesAsync(IStorageFile, Byte[])	Schreibt ein Array von Datenbytes in die angegebene Datei.
WriteLinesAsync(IStorageFile, IIterable<String>)	Schreibt Textzeilen in die angegebene Datei.
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Schreibt Textzeilen mithilfe der angegebenen Zeichencodierung in die angegebene Datei.
WriteTextAsync(IStorageFile, String)	Schreibt Text in die angegebene Datei.
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	Schreibt Text mithilfe der angegebenen Zeichencodierung in die angegebene Datei.