StringReader Clase

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

StringReader.cs

Implementa TextReader que lee en una cadena.

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Herencia

Object

MarshalByRefObject

TextReader

StringReader

Ejemplos

En el ejemplo siguiente se muestra cómo leer una cadena completa de forma asincrónica.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Comentarios

StringReader permite leer una cadena de forma sincrónica o asincrónica. Puede leer un carácter a la vez con el Read método o ReadAsync , una línea a la vez mediante el ReadLine método o y ReadLineAsync una cadena completa mediante el ReadToEndReadToEndAsync método o .

Nota

Este tipo implementa la interfaz de IDisposable, pero no ofrece ningún recurso. Esto quiere decir que no es necesario llamar a Dispose() ni usar ningún lenguaje de construcción como using (en C#) o Using (en Visual Basic) para disponer de él.

En la tabla siguiente se enumeran ejemplos de otras tareas de E/S típicas o relacionadas.

Para...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Lee desde un archivo de texto.	Cómo: Leer texto de un archivo
Anexar texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtiene el tamaño de un archivo.	FileInfo.Length
Obtenga los atributos de un archivo.	File.GetAttributes
Establezca los atributos de un archivo.	File.SetAttributes
Determine si existe un archivo.	File.Exists
Lee desde un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escriba en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Constructores

StringReader(String)

Inicializa una nueva instancia de la clase StringReader que lee en la cadena especificada.

Métodos

Close()	Cierra el objeto StringReader.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos utilizados por el objeto TextReader. (Heredado de TextReader)
Dispose(Boolean)	Libera los recursos no administrados que usa StringReader y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Peek()	Devuelve el siguiente carácter disponible pero no lo consume.
Read()	Lee el siguiente carácter de la cadena de entrada y hace avanzar la posición de los caracteres en un carácter.
Read(Char[], Int32, Int32)	Lee un bloque de caracteres de la cadena de entrada y hace avanzar la posición de los caracteres en count.
Read(Span<Char>)	Lee todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.
ReadAsync(Char[], Int32, Int32)	Lee de forma asincrónica un número máximo de caracteres especificado en la cadena actual y escribe los datos en un búfer, comenzando en el índice especificado.
ReadAsync(Memory<Char>, CancellationToken)	Lee de forma asincrónica todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.
ReadBlock(Char[], Int32, Int32)	Lee un número máximo de caracteres especificado en el lector de texto actual y escribe los datos en un búfer, comenzando en el índice especificado. (Heredado de TextReader)
ReadBlock(Span<Char>)	Lee todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.
ReadBlockAsync(Char[], Int32, Int32)	Lee de forma asincrónica un número máximo de caracteres especificado en la cadena actual y escribe los datos en un búfer, comenzando en el índice especificado.
ReadBlockAsync(Memory<Char>, CancellationToken)	Lee de forma asincrónica todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.
ReadLine()	Lee una línea de caracteres de la cadena actual y devuelve los datos como una cadena.
ReadLineAsync()	Lee de forma asincrónica una línea de caracteres de la cadena actual y devuelve los datos como una cadena.
ReadLineAsync(CancellationToken)	Lee de forma asincrónica una línea de caracteres de la cadena actual y devuelve los datos como una cadena.
ReadToEnd()	Lee todos los caracteres desde la posición actual hasta el final de la cadena y los devuelve como una cadena única.
ReadToEndAsync()	Lee de forma asincrónica todos los caracteres desde la posición actual hasta el final de la cadena y los devuelve como una cadena única.
ReadToEndAsync(CancellationToken)	Lee de forma asincrónica todos los caracteres desde la posición actual hasta el final de la cadena y los devuelve como una cadena única.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• TextReader
• StringWriter
• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo