PathIO Klasse

Referenz

Definition

Namespace:: Windows.Storage

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

Stellt Hilfsmethoden zum Lesen und Schreiben einer Datei mithilfe des absoluten Pfads oder des URI (Uniform Resource Identifier) der Datei bereit.

public ref class PathIO 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 PathIO 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 PathIO

Public Class PathIO

Vererbung: Object Platform::Object IInspectable PathIO

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

Sie können WriteTextAsync(filePathOrURI, contents) verwenden, um Text in eine Datei zu schreiben. Im Beispiel ist eine lokale Variable, filePathOrURI die einen URI (z. B. einen App-URI "ms-appdata://sampleFile.dat") oder einen Dateisystempfad (z. B. C:\examplepath\sampleFile.dat) für die zu lesende Datei enthält. 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.

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

Sie können ReadTextAsync(filePathOrURI) verwenden, um Text aus einer Datei zu lesen. Nach Abschluss von ReadTextAsync ruft die fileContent Variable den Inhalt der Datei als Textzeichenfolge ab. Anschließend können Sie den Inhalt entsprechend verarbeiten.

try
{
    if (file != null)
    {
        string fileContent = await PathIO.ReadTextAsync(filePathOrURI);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

Weitere verwandte Beispiele finden Sie unter Dateizugriffsbeispiel und FileIO.

Hinweise

Um eine Datei mit einem Pfad oder einem URI (Uniform Resource Identifier) zu lesen oder in eine Datei zu schreiben, müssen Sie über die Berechtigung verfügen, auf den Speicherort der Datei zuzugreifen. Weitere Informationen zu den Speicherorten, auf die Ihre App zugreifen kann, finden Sie unter Dateizugriffsberechtigungen.

Sie können einen App-URI (Uniform Resource Identifier) angeben, um Dateien an app-spezifischen Speicherorten wie Ihrem App-Datenordner ("ms-appdata://") zu lesen oder zu schreiben. Weitere Informationen zum App-URI (Uniform Resource Identifier) finden Sie unter Verweisen auf Inhalte.

Methoden

AppendLinesAsync(String, IIterable<String>)	Fügt Textzeilen an die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) an.
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	Fügt textzeilen an die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) an, wobei die angegebene Zeichencodierung verwendet wird.
AppendTextAsync(String, String)	Fügt Text an die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) an.
AppendTextAsync(String, String, UnicodeEncoding)	Fügt text an die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) an, wobei die angegebene Zeichencodierung verwendet wird.
ReadBufferAsync(String)	Liest den Inhalt der Datei am angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) und gibt einen Puffer zurück.
ReadLinesAsync(String)	Liest den Inhalt der Datei am angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) und gibt Textzeilen zurück.
ReadLinesAsync(String, UnicodeEncoding)	Liest den Inhalt der Datei am angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) unter Verwendung der angegebenen Zeichencodierung und gibt Textzeilen zurück.
ReadTextAsync(String)	Liest den Inhalt der Datei unter dem angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) und gibt Text zurück.
ReadTextAsync(String, UnicodeEncoding)	Liest den Inhalt der Datei am angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) unter Verwendung der angegebenen Zeichencodierung und gibt Text zurück.
WriteBufferAsync(String, IBuffer)	Schreibt Daten aus einem Puffer unter dem angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier) in die Datei.
WriteBytesAsync(String, Byte[])	Schreibt ein einzelnes Byte von Daten in die Datei unter dem angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier).
WriteLinesAsync(String, IIterable<String>)	Schreibt Textzeilen in die Datei unter dem angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier).
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	Schreibt Textzeilen in die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) unter Verwendung der angegebenen Zeichencodierung.
WriteTextAsync(String, String)	Schreibt Text in die Datei unter dem angegebenen Pfad oder dem angegebenen URI (Uniform Resource Identifier).
WriteTextAsync(String, String, UnicodeEncoding)	Schreibt Text in die Datei am angegebenen Pfad oder am angegebenen URI (Uniform Resource Identifier) unter Verwendung der angegebenen Zeichencodierung.

Gilt für: