StringReader Clase

Definición

Implementa TextReader que lee en una cadena.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
[<System.Serializable>]
type StringReader = class
    inherit TextReader
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Herencia
StringReader
Herencia
Atributos

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 ReadToEnd ReadToEndAsync 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.

Close()

Cierra el TextReader y libera todos los recursos del sistema asociados a TextReader.

(Heredado de TextReader)
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()
Obsoleto.

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()
Obsoleto.

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.

Read(Span<Char>)

Lee los caracteres del lector actual y escribe los datos en el búfer especificado.

(Heredado de TextReader)
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(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en el lector de texto actual de forma asincrónica y escribe los datos en un búfer, comenzando en el índice especificado.

(Heredado de TextReader)
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.

ReadAsync(Memory<Char>, CancellationToken)

Lee de forma asincrónica los caracteres de la secuencia actual en un bloque de memoria.

(Heredado de TextReader)
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.

ReadBlock(Span<Char>)

Lee los caracteres de la secuencia actual y escribe los datos en un búfer.

(Heredado de TextReader)
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(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en el lector de texto actual de forma asincrónica y escribe los datos en un búfer, comenzando en el índice especificado.

(Heredado de TextReader)
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.

ReadBlockAsync(Memory<Char>, CancellationToken)

Lee de forma asincrónica los caracteres de la secuencia actual y escribe los datos en un búfer.

(Heredado de TextReader)
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()

Lee de forma asincrónica una línea de caracteres y devuelve los datos como una cadena.

(Heredado de TextReader)
ReadLineAsync(CancellationToken)

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 y devuelve los datos como una cadena.

(Heredado de TextReader)
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()

Lee de forma asincrónica todos los caracteres desde la posición actual hasta el final del lector de texto y los devuelve como una cadena.

(Heredado de TextReader)
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.

ReadToEndAsync(CancellationToken)

Lee de forma asincrónica todos los caracteres desde la posición actual hasta el final del lector de texto y los devuelve como una cadena.

(Heredado de TextReader)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Para obtener una descripción de este miembro, vea Dispose().

(Heredado de TextReader)

Se aplica a

Consulte también