StringReader Clase

Definición

Espacio de nombres:

System.IO

Ensamblado:

mscorlib.dll

Implementa un TextReader objeto que lee de una cadena.

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

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Herencia

Object

MarshalByRefObject

TextReader

StringReader

Atributos

SerializableAttribute ComVisibleAttribute

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 o Read el ReadAsync método , una línea a la vez mediante el ReadLine método o ReadLineAsync y una cadena completa mediante o ReadToEnd el ReadToEndAsync método o .

Note

Este tipo implementa la IDisposable interfaz, pero realmente no tiene ningún recurso para eliminar. Esto significa que no es necesario eliminarlo llamando directamente a Dispose() o mediante una construcción de lenguaje como using (en C#) o Using (en Visual Basic).

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

Para ello...	Vea el ejemplo de este tema...
Cree 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
Anexe texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtenga el tamaño de un archivo.	FileInfo.Length
Obtiene 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
Escribir en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Constructores

Nombre	Description
StringReader(String)	Inicializa una nueva instancia de la StringReader clase que lee de la cadena especificada.

Métodos

Nombre	Description
Close()	Cierra .StringReader
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos utilizados por el TextReader objeto . (Heredado de TextReader)
Dispose(Boolean)	Libera los recursos no administrados utilizados por StringReader y, opcionalmente, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	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()	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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (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 avanza la posición del carácter por un carácter.
Read(Char[], Int32, Int32)	Lee un bloque de caracteres de la cadena de entrada y avanza la posición del carácter por count.
ReadAsync(Char[], Int32, Int32)	Lee un número máximo especificado de caracteres de la cadena actual de forma asincrónica y escribe los datos en un búfer, empezando por el índice especificado.
ReadBlock(Char[], Int32, Int32)	Lee un número máximo especificado de caracteres del lector de texto actual y escribe los datos en un búfer, empezando por el índice especificado. (Heredado de TextReader)
ReadBlockAsync(Char[], Int32, Int32)	Lee un número máximo especificado de caracteres de la cadena actual de forma asincrónica y escribe los datos en un búfer, empezando por el índice especificado.
ReadLine()	Lee una línea de caracteres de la cadena actual y devuelve los datos como una cadena.
ReadLineAsync()	Lee una línea de caracteres de forma asincrónica desde la cadena actual y devuelve los datos como una cadena.
ReadToEnd()	Lee todos los caracteres de la posición actual hasta el final de la cadena y los devuelve como una sola cadena.
ReadToEndAsync()	Lee todos los caracteres de la posición actual hasta el final de la cadena de forma asincrónica y los devuelve como una sola cadena.
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