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

Definición

Abre un archivo de texto, lee todo el texto del archivo en una cadena y, a continuación, cierra el archivo.Opens a text file, reads all the text in the file into a string, and then closes the file.

Sobrecargas

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

Abre un archivo, lee todo el texto del archivo con la codificación especificada y, a continuación, cierra el archivo.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)

Abre un archivo de texto, lee todo el texto del archivo y, a continuación, cierra el archivo.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)

Abre un archivo, lee todo el texto del archivo con la codificación especificada y, a continuación, cierra el archivo.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

Parámetros

path
String String String String

Archivo que se abre para la lectura.The file to open for reading.

encoding
Encoding Encoding Encoding Encoding

Codificación aplicada al contenido del archivo.The encoding applied to the contents of the file.

Devoluciones

Cadena que contiene todo el texto del archivo.A string containing all text in the file.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

O bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

O bien-or- path especificó un directorio.path specified a directory.

O bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

No se encontró el archivo especificado en path.The file specified in path was not found.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el ReadAllText uso del método para mostrar el contenido de un archivo.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. En este ejemplo, se crea un archivo, si aún no existe, y se le agrega texto.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
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

Comentarios

Este método abre un archivo, Lee todo el texto del archivo y lo devuelve como una cadena.This method opens a file, reads all the text in the file, and returns it as a string. A continuación, cierra el archivo.It then closes the file.

Este método intenta detectar automáticamente la codificación de un archivo en función de la presencia de marcas de orden de bytes.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Se pueden detectar los formatos de codificación UTF-8 y UTF-32 (Big-endian y Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Se garantiza que el identificador de archivo está cerrado por este método, aunque se produzcan excepciones.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Para usar la configuración de codificación tal y como se ha configurado para el sistema Encoding.Default operativo, especifique encoding la propiedad para el parámetro.To use the encoding settings as configured for your operating system, specify the Encoding.Default property for the encoding parameter.

Seguridad

FileIOPermission
para obtener acceso para leer desde un archivo o un directorio.for access to read from a file or directory. Enumeración asociada:ReadAssociated enumeration: Read

Consulte también:

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

Abre un archivo de texto, lee todo el texto del archivo y, a continuación, cierra el archivo.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

Parámetros

path
String String String String

Archivo que se abre para la lectura.The file to open for reading.

Devoluciones

Cadena que contiene todo el texto del archivo.A string containing all the text in the file.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

O bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- path especificó un directorio.path specified a directory.

o bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

No se encontró el archivo especificado en path.The file specified in path was not found.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el ReadAllText uso del método para mostrar el contenido de un archivo.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. En este ejemplo, se crea un archivo, si aún no existe, y se le agrega texto.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
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

Comentarios

Este método abre un archivo, Lee todo el texto del archivo y lo devuelve como una cadena.This method opens a file, reads all the text in the file, and returns it as a string. A continuación, cierra el archivo.It then closes the file.

Este método intenta detectar automáticamente la codificación de un archivo en función de la presencia de marcas de orden de bytes.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Se pueden detectar los formatos de codificación UTF-8 y UTF-32 (Big-endian y Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Utilice la ReadAllText(String, Encoding) sobrecarga del método al leer archivos que pueden contener texto importado, ya que es posible que los caracteres no reconocidos no se lean correctamente.Use the ReadAllText(String, Encoding) method overload when reading files that might contain imported text, because unrecognized characters may not be read correctly.

Se garantiza que el identificador de archivo está cerrado por este método, aunque se produzcan excepciones.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Seguridad

FileIOPermission
para obtener acceso para leer desde un archivo o un directorio.for access to read from a file or directory. Enumeración asociada:ReadAssociated enumeration: Read

Consulte también:

Se aplica a