FileIO Classe

Definizione

Spazio dei nomi:

Windows.Storage

Fornisce metodi helper per la lettura e la scrittura di file rappresentati da oggetti di tipo IStorageFile.

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

Ereditarietà

Object Platform::Object IInspectable FileIO

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di accesso ai file illustra come usare WriteTextAsync(file, contents) per scrivere testo in un file.

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
    }
}

Nell'esempio file è una variabile locale che contiene un oggetto StorageFile che rappresenta il file da scrivere.

Anche se i metodi WriteTextAsync non hanno un valore restituito, è comunque possibile eseguire attività aggiuntive dopo la scrittura del testo nel file, come illustrato nell'esempio. L'esempio di accesso ai file illustra anche come usare ReadTextAsync(file) per leggere il testo da un file.

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
    }
}

Nell'esempio file è una variabile locale che contiene un oggetto StorageFile che rappresenta il file da leggere.

Al termine di ReadTextAsync , la fileContent variabile ottiene il contenuto del file come stringa di testo. È quindi possibile elaborare il contenuto in base alle esigenze.

Commenti

Questa classe è statica e non può essere creata un'istanza. Chiamare i metodi direttamente.

Per altre informazioni sulle posizioni a cui l'app può accedere, vedere Autorizzazioni di accesso ai file.

Per informazioni su come leggere e scrivere nei file, vedere Creare, scrivere e leggere un file.

Metodi

AppendLinesAsync(IStorageFile, IIterable<String>)	Aggiunge righe di testo al file specificato.
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Aggiunge righe di testo al file specificato utilizzando la codifica dei caratteri specificata.
AppendTextAsync(IStorageFile, String)	Aggiunge testo al file specificato.
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	Aggiunge testo al file specificato utilizzando la codifica dei caratteri specificata.
ReadBufferAsync(IStorageFile)	Legge il contenuto del file specificato e restituisce un buffer.
ReadLinesAsync(IStorageFile)	Legge il contenuto del file specificato e restituisce righe di testo.
ReadLinesAsync(IStorageFile, UnicodeEncoding)	Legge il contenuto del file specificato utilizzando la codifica dei caratteri specificata e restituisce righe di testo.
ReadTextAsync(IStorageFile)	Legge il contenuto del file specificato e restituisce testo.
ReadTextAsync(IStorageFile, UnicodeEncoding)	Legge il contenuto del file specificato utilizzando la codifica dei caratteri specificata e restituisce testo.
WriteBufferAsync(IStorageFile, IBuffer)	Scrive i dati da un buffer nel file specificato.
WriteBytesAsync(IStorageFile, Byte[])	Scrive una matrice di byte di dati nel file specificato.
WriteLinesAsync(IStorageFile, IIterable<String>)	Scrive righe di testo nel file specificato.
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Scrive righe di testo nel file specificato usando la codifica dei caratteri specificata.
WriteTextAsync(IStorageFile, String)	Scrive testo nel file specificato.
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	Scrive testo nel file specificato usando la codifica dei caratteri specificata.