StreamReader Constructores

Definición

Espacio de nombres:: System.IO

Ensamblados:: mscorlib.dll, System.IO.dll

Ensamblados:: netstandard.dll, System.Runtime.dll

Ensamblado:: System.IO.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada.

Sobrecargas

Nombre	Description
StreamReader(Stream)	Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada.
StreamReader(Stream, Encoding, Boolean, Int32, Boolean)	Inicializa una nueva instancia de la clase para la StreamReader secuencia especificada en función de la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y el tamaño del búfer, y, opcionalmente, deja abierta la secuencia.
StreamReader(String, Encoding, Boolean, FileStreamOptions)	Inicializa una nueva instancia de la StreamReader clase para la ruta de acceso de archivo especificada, con la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y configurada con el objeto especificado FileStreamOptions .
StreamReader(String, Encoding, Boolean, Int32)	Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y el tamaño del búfer.
StreamReader(Stream, Encoding, Boolean, Int32)	Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la codificación de caracteres, la opción de detección de marcas de orden de bytes y el tamaño del búfer especificados.
StreamReader(Stream, Encoding, Boolean)	Inicializa una nueva instancia de la clase para la StreamReader secuencia especificada, con la opción de detección de marcas de orden de bytes y codificación de caracteres especificada.
StreamReader(String, Encoding, Boolean)	Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la opción de detección de marcas de orden de bytes y codificación de caracteres especificada.
StreamReader(String, FileStreamOptions)	Inicializa una nueva instancia de la clase para la StreamReader ruta de acceso de archivo especificada, utilizando la codificación predeterminada, habilitando la detección de marcas de orden de bytes al principio del archivo y configuradas con el objeto especificado FileStreamOptions .
StreamReader(String, Boolean)	Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la opción de detección de marcas de orden de bytes especificada.
StreamReader(Stream, Encoding)	Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la codificación de caracteres especificada.
StreamReader(Stream, Boolean)	Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la opción de detección de marcas de orden de bytes especificada.
StreamReader(String)	Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado.
StreamReader(String, Encoding)	Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la codificación de caracteres especificada.

StreamReader(Stream)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada.

public:
 StreamReader(System::IO::Stream ^ stream);

public StreamReader(System.IO.Stream stream);

new System.IO.StreamReader : System.IO.Stream -> System.IO.StreamReader

Public Sub New (stream As Stream)

Parámetros

stream: Stream

Secuencia que se va a leer.

Excepciones

ArgumentException

stream no admite la lectura.

ArgumentNullException

stream es null.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

using System;
using System.IO;

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

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(new FileStream(path, FileMode.CreateNew)))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("reading");
            }

            using (StreamReader sr = new StreamReader(new FileStream(path, FileMode.Open)))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO

Public Class Test

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

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim fs As FileStream = New FileStream(path, FileMode.Open)

            Dim sr As StreamReader = New StreamReader(fs)

            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
            sr.Close()
            fs.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Comentarios

Este constructor inicializa la codificación UTF8Encodingen , la BaseStream propiedad utilizando el stream parámetro y el tamaño del búfer interno a 1024 bytes.

El StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

Precaución

Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se puedan interpretar y podrían provocar una excepción.

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean, Int32, Boolean)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la clase para la StreamReader secuencia especificada en función de la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y el tamaño del búfer, y, opcionalmente, deja abierta la secuencia.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding = default, bool detectEncodingFromByteOrderMarks = true, int bufferSize = -1, bool leaveOpen = false);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool * int * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer, leaveOpen As Boolean)

Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional detectEncodingFromByteOrderMarks As Boolean = true, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

Parámetros

stream: Stream

Secuencia que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

true para buscar marcas de orden de bytes al principio del archivo; de lo contrario, false.

bufferSize: Int32

Tamaño mínimo del búfer, en bytes.

leaveOpen: Boolean

true es para dejar abierta la secuencia después de eliminar el StreamReader objeto; de lo contrario, falsees .

Comentarios

A menos que establezca el leaveOpen parámetro trueen , el StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

El parámetro establece el tamaño del bufferSize búfer, en bytes. Si bufferSize es menor que el tamaño mínimo permitido (128 bytes), se usa el tamaño mínimo permitido.

Este constructor le permite cambiar la codificación la primera vez que lea del StreamReader objeto . Si el detectEncodingFromByteOrderMarks parámetro es true, el constructor detecta la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, se usa la codificación proporcionada por el usuario. Consulte el Encoding.GetPreamble método para obtener más información.

Nota:

Al leer desde , Streames más eficaz usar un búfer que tenga el mismo tamaño que el búfer interno de la secuencia.

Precaución

Al compilar un conjunto de caracteres con una configuración cultural determinada y recuperar esos mismos caracteres con una configuración cultural diferente, es posible que los caracteres no se interpreten correctamente y podrían provocar una excepción.

Se aplica a

StreamReader(String, Encoding, Boolean, FileStreamOptions)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para la ruta de acceso de archivo especificada, con la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y configurada con el objeto especificado FileStreamOptions .

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, System::IO::FileStreamOptions ^ options);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, System.IO.FileStreamOptions options);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, System.IO.FileStreamOptions options);

new System.IO.StreamReader : string * System.Text.Encoding * bool * System.IO.FileStreamOptions -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, options As FileStreamOptions)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

options: FileStreamOptions

Objeto que especifica las opciones de configuración para el objeto subyacente FileStream.

Excepciones

ArgumentException

path no es legible.

      -or-

path es una cadena vacía ("").

ArgumentNullException

path o encoding es optionsnull.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

NotSupportedException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Consulte también

Se aplica a

StreamReader(String, Encoding, Boolean, Int32)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la codificación de caracteres especificada, la opción de detección de marcas de orden de bytes y el tamaño del búfer.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

new System.IO.StreamReader : string * System.Text.Encoding * bool * int -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

bufferSize: Int32

Tamaño mínimo del búfer, en bytes.

Excepciones

ArgumentException

path es una cadena vacía ("").

ArgumentNullException

path o encoding es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

NotSupportedException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

ArgumentOutOfRangeException

bufferSize es menor o igual que cero, excepto -1, que puede indicar el tamaño predeterminado del búfer.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación tal como especifica el encoding parámetro .

Este constructor permite cambiar la codificación la primera vez que lea del StreamReader objeto . El detectEncodingFromByteOrderMarks parámetro detecta la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, se usa la codificación proporcionada por el usuario. Consulte el Encoding.GetPreamble método para obtener más información.

El parámetro establece el tamaño del bufferSize búfer, en bytes. Si bufferSize es menor que el tamaño mínimo permitido (128 bytes), se usa el tamaño mínimo permitido.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de Convención de nomenclatura universal (UNC).

No es necesario que el path parámetro sea un archivo almacenado en el disco; puede ser cualquier parte de un sistema que admita el acceso mediante secuencias.

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean, Int32)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la codificación de caracteres, la opción de detección de marcas de orden de bytes y el tamaño del búfer especificados.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool * int -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer)

Parámetros

stream: Stream

Secuencia que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

bufferSize: Int32

Tamaño mínimo del búfer, en bytes.

Excepciones

ArgumentException

La secuencia no admite la lectura.

ArgumentNullException

stream o encoding es null.

ArgumentOutOfRangeException

bufferSize es menor o igual que cero, excepto -1, que puede indicar el tamaño predeterminado del búfer.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

El parámetro establece el tamaño del bufferSize búfer, en bytes. Si bufferSize es menor que el tamaño mínimo permitido (128 bytes), se usa el tamaño mínimo permitido.

El StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

Nota:

Al leer desde , Streames más eficaz usar un búfer que tenga el mismo tamaño que el búfer interno de la secuencia.

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la clase para la StreamReader secuencia especificada, con la opción de detección de marcas de orden de bytes y codificación de caracteres especificada.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean)

Parámetros

stream: Stream

Secuencia que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

Excepciones

ArgumentException

stream no admite la lectura.

ArgumentNullException

stream o encoding es null.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación tal como especifica el encoding parámetro , la BaseStream propiedad mediante el stream parámetro y el tamaño del búfer interno a 1024 bytes.

El detectEncodingFromByteOrderMarks parámetro detecta la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, se usa la codificación proporcionada por el usuario. Consulte el Encoding.GetPreamble método para obtener más información.

El StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(String, Encoding, Boolean)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la opción de detección de marcas de orden de bytes y codificación de caracteres especificada.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : string * System.Text.Encoding * bool -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

Excepciones

ArgumentException

path es una cadena vacía ("").

ArgumentNullException

path o encoding es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

NotSupportedException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación tal como especifica el encoding parámetro y el tamaño del búfer interno en 1024 bytes.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de Convención de nomenclatura universal (UNC).

No es necesario que el path parámetro sea un archivo almacenado en el disco; puede ser cualquier parte de un sistema que admita el acceso mediante secuencias.

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(String, FileStreamOptions)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la clase para la StreamReader ruta de acceso de archivo especificada, utilizando la codificación predeterminada, habilitando la detección de marcas de orden de bytes al principio del archivo y configuradas con el objeto especificado FileStreamOptions .

public:
 StreamReader(System::String ^ path, System::IO::FileStreamOptions ^ options);

public StreamReader(string path, System.IO.FileStreamOptions options);

new System.IO.StreamReader : string * System.IO.FileStreamOptions -> System.IO.StreamReader

Public Sub New (path As String, options As FileStreamOptions)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

options: FileStreamOptions

Objeto que especifica las opciones de configuración para el objeto subyacente FileStream.

Excepciones

ArgumentException

path no es legible.

O bien

      <code data-dev-comment-type="paramref">path</code> is an empty string ("").

ArgumentNullException

path o options es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

IOException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Consulte también

Se aplica a

StreamReader(String, Boolean)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la opción de detección de marcas de orden de bytes especificada.

public:
 StreamReader(System::String ^ path, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : string * bool -> System.IO.StreamReader

Public Sub New (path As String, detectEncodingFromByteOrderMarks As Boolean)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

Excepciones

ArgumentException

path es una cadena vacía ("").

ArgumentNullException

path es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

IOException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación UTF8Encodingen , la BaseStream propiedad utilizando el stream parámetro y el tamaño del búfer interno a 1024 bytes.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de Convención de nomenclatura universal (UNC).

No es necesario que el path parámetro sea un archivo almacenado en el disco; puede ser cualquier parte de un sistema que admita el acceso mediante secuencias.

El detectEncodingFromByteOrderMarks parámetro detecta la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, UTF8Encoding se usa . Consulte el Encoding.GetPreamble método para obtener más información.

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(Stream, Encoding)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la codificación de caracteres especificada.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding)

Parámetros

stream: Stream

Secuencia que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

Excepciones

ArgumentException

stream no admite la lectura.

ArgumentNullException

stream o encoding es null.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

El parámetro establece la encoding codificación de caracteres y el tamaño del búfer se establece en 1024 bytes. El StreamReader objeto intenta detectar la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, se usa la codificación proporcionada por el usuario. Consulte el Encoding.GetPreamble método para obtener más información.

El StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(Stream, Boolean)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para la secuencia especificada, con la opción de detección de marcas de orden de bytes especificada.

public:
 StreamReader(System::IO::Stream ^ stream, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : System.IO.Stream * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, detectEncodingFromByteOrderMarks As Boolean)

Parámetros

stream: Stream

Secuencia que se va a leer.

detectEncodingFromByteOrderMarks: Boolean

Indica si se deben buscar marcas de orden de bytes al principio del archivo.

Excepciones

ArgumentException

stream no admite la lectura.

ArgumentNullException

stream es null.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación UTF8Encodingen , la BaseStream propiedad utilizando el stream parámetro y el tamaño del búfer interno a 1024 bytes.

El detectEncodingFromByteOrderMarks parámetro detecta la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. Consulte el Encoding.GetPreamble método para obtener más información.

El StreamReader objeto llama Dispose() al objeto proporcionado Stream cuando StreamReader.Dispose se llama a .

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(String)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado.

public:
 StreamReader(System::String ^ path);

public StreamReader(string path);

new System.IO.StreamReader : string -> System.IO.StreamReader

Public Sub New (path As String)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

Excepciones

ArgumentException

path es una cadena vacía ("").

ArgumentNullException

path es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

IOException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

using System;
using System.IO;

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

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO

Public Class Test

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

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim sr As StreamReader = New StreamReader(path)

            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
            sr.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Comentarios

El parámetro especifica la ruta de acceso completa del path archivo. Este constructor inicializa la codificación en UTF8Encoding y el tamaño del búfer en 1024 bytes.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de Convención de nomenclatura universal (UNC).

No es necesario que el path parámetro sea un archivo almacenado en el disco; puede ser cualquier parte de un sistema que admita el acceso mediante secuencias.

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

StreamReader(String, Encoding)

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Source:: StreamReader.cs

Inicializa una nueva instancia de la StreamReader clase para el nombre de archivo especificado, con la codificación de caracteres especificada.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding);

public StreamReader(string path, System.Text.Encoding? encoding);

public StreamReader(string path, System.Text.Encoding encoding);

new System.IO.StreamReader : string * System.Text.Encoding -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding)

Parámetros

path: String

Ruta de acceso completa del archivo que se va a leer.

encoding: Encoding

Codificación de caracteres que se va a usar.

Excepciones

ArgumentException

path es una cadena vacía ("").

ArgumentNullException

path o encoding es null.

FileNotFoundException

No se encuentra el archivo.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, como estar en una unidad no asignada.

NotSupportedException

path incluye una sintaxis incorrecta o no válida para el nombre de archivo, el nombre del directorio o la etiqueta de volumen.

Ejemplos

En el ejemplo de código siguiente se muestra este StreamReader constructor.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Comentarios

Este constructor inicializa la codificación tal como especifica el encoding parámetro y el tamaño del búfer interno en 1024 bytes. El StreamReader objeto intenta detectar la codificación examinando los cuatro primeros bytes de la secuencia. Reconoce automáticamente UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 y texto big-endian UTF-32 si el archivo comienza con las marcas de orden de bytes adecuadas. De lo contrario, se usa la codificación proporcionada por el usuario. Consulte el Encoding.GetPreamble método para obtener más información.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de Convención de nomenclatura universal (UNC).

No es necesario que el path parámetro sea un archivo almacenado en el disco; puede ser cualquier parte de un sistema que admita el acceso mediante secuencias.

Precaución

Para obtener una lista de tareas comunes de E/S, consulte Tareas comunes de E/S.

Consulte también

Se aplica a

Comentarios

Resultoulle útil esta páxina?

Compartir por

StreamReader Constructores

Definición

Sobrecargas

StreamReader(Stream)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean, Int32, Boolean)

Parámetros

Comentarios

Se aplica a

StreamReader(String, Encoding, Boolean, FileStreamOptions)

Parámetros

Excepciones

Consulte también

Se aplica a

StreamReader(String, Encoding, Boolean, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(Stream, Encoding, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(String, Encoding, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(String, FileStreamOptions)

Parámetros

Excepciones

Consulte también

Se aplica a

StreamReader(String, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(Stream, Encoding)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(Stream, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StreamReader(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también