File.ReadAllText File.ReadAllText File.ReadAllText File.ReadAllText Method

Definizione

Apre un file di testo, ne legge tutto il testo in una stringa e quindi lo chiude.Opens a text file, reads all the text in the file into a string, and then closes the file.

Overload

ReadAllText(String, Encoding) ReadAllText(String, Encoding) ReadAllText(String, Encoding)

Apre un file, ne legge tutto il testo le righe con la codifica specificata e quindi lo chiude.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

ReadAllText(String) ReadAllText(String) ReadAllText(String) ReadAllText(String)

Apre un file di testo, legge tutto il testo del file e quindi lo chiude.Opens a text file, reads all the text in the file, and then closes the file.

ReadAllText(String, Encoding) ReadAllText(String, Encoding) ReadAllText(String, Encoding)

Apre un file, ne legge tutto il testo le righe con la codifica specificata e quindi lo chiude.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

public:
 static System::String ^ ReadAllText(System::String ^ path, System::Text::Encoding ^ encoding);
public static string ReadAllText (string path, System.Text.Encoding encoding);
static member ReadAllText : string * System.Text.Encoding -> string

Parametri

path
String String String String

File da aprire per la lettura.The file to open for reading.

encoding
Encoding Encoding Encoding Encoding

Codifica applicata al contenuto del file.The encoding applied to the contents of the file.

Restituisce

Stringa che contiene tutto il testo del file.A string containing all text in the file.

Eccezioni

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid (for example, it is on an unmapped drive).

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

path specifica un file di sola lettura.path specified a file that is read-only.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

In alternativa-or- path ha specificato una directory.path specified a directory.

In alternativa-or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Il file specificato in path non è stato trovato.The file specified in path was not found.

Il formato di path non è valido.path is in an invalid format.

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ReadAllText l'utilizzo del metodo per visualizzare il contenuto di un file.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. In questo esempio viene creato un file, se non esiste già, e viene aggiunto un testo.In this example a file is created, if it doesn't already exist, and text is added to it.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText, Encoding.UTF8)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText, Encoding.UTF8)

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Commenti

Questo metodo apre un file, legge tutto il testo nel file e lo restituisce come stringa.This method opens a file, reads all the text in the file, and returns it as a string. Quindi chiude il file.It then closes the file.

Questo metodo tenta di rilevare automaticamente la codifica di un file in base alla presenza di indicatori per l'ordine dei byte.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. È possibile rilevare i formati di codifica UTF-8 e UTF-32 (sia Big-Endian che Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

L'handle di file è sicuramente chiuso da questo metodo, anche se vengono generate eccezioni.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Per usare le impostazioni di codifica configurate per il sistema operativo, Encoding.Default specificare la proprietà encoding per il parametro.To use the encoding settings as configured for your operating system, specify the Encoding.Default property for the encoding parameter.

Sicurezza

FileIOPermission
per accedere alla lettura da un file o da una directory.for access to read from a file or directory. Enumerazione associata:ReadAssociated enumeration: Read

Vedi anche

ReadAllText(String) ReadAllText(String) ReadAllText(String) ReadAllText(String)

Apre un file di testo, legge tutto il testo del file e quindi lo chiude.Opens a text file, reads all the text in the file, and then closes the file.

public:
 static System::String ^ ReadAllText(System::String ^ path);
public static string ReadAllText (string path);
static member ReadAllText : string -> string
Public Shared Function ReadAllText (path As String) As String

Parametri

path
String String String String

File da aprire per la lettura.The file to open for reading.

Restituisce

Stringa che contiene tutto il testo del file.A string containing all the text in the file.

Eccezioni

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid (for example, it is on an unmapped drive).

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

path specifica un file di sola lettura.path specified a file that is read-only.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

In alternativa-or- path ha specificato una directory.path specified a directory.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Il file specificato in path non è stato trovato.The file specified in path was not found.

Il formato di path non è valido.path is in an invalid format.

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ReadAllText l'utilizzo del metodo per visualizzare il contenuto di un file.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. In questo esempio viene creato un file, se non esiste già, e viene aggiunto un testo.In this example a file is created, if it doesn't already exist, and text is added to it.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText)

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Commenti

Questo metodo apre un file, legge tutto il testo nel file e lo restituisce come stringa.This method opens a file, reads all the text in the file, and returns it as a string. Quindi chiude il file.It then closes the file.

Questo metodo tenta di rilevare automaticamente la codifica di un file in base alla presenza di indicatori per l'ordine dei byte.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. È possibile rilevare i formati di codifica UTF-8 e UTF-32 (sia Big-Endian che Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Utilizzare l' ReadAllText(String, Encoding) overload del metodo durante la lettura dei file che potrebbero contenere testo importato, perché non è possibile leggere correttamente i caratteri non riconosciuti.Use the ReadAllText(String, Encoding) method overload when reading files that might contain imported text, because unrecognized characters may not be read correctly.

L'handle di file è sicuramente chiuso da questo metodo, anche se vengono generate eccezioni.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Sicurezza

FileIOPermission
per accedere alla lettura da un file o da una directory.for access to read from a file or directory. Enumerazione associata:ReadAssociated enumeration: Read

Vedi anche

Si applica a