Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

TextReader (Clase)

 

Representa un lector que puede leer una serie secuencial de caracteres.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.MarshalByRefObject
    System.IO.TextReader
      System.IO.StreamReader
      System.IO.StringReader

[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class TextReader : MarshalByRefObject, IDisposable

NombreDescripción
System_CAPS_protmethodTextReader()

Inicializa una nueva instancia de la clase TextReader.

NombreDescripción
System_CAPS_pubmethodClose()

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

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libera todos los recursos utilizados por el objeto TextReader.

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa TextReader y libera los recursos administrados de forma opcional.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object.)

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodPeek()

Lee el siguiente carácter sin modificar el estado del sistema de lectura o el origen del carácter. Devuelve el siguiente carácter disponible sin leerlo realmente del lector.

System_CAPS_pubmethodRead()

Lee el siguiente carácter en el lector de texto y hace avanzar la posición de los caracteres en un carácter.

System_CAPS_pubmethodRead(Char[], Int32, Int32)

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

System_CAPS_pubmethodReadAsync(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.

System_CAPS_pubmethodReadBlock(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.

System_CAPS_pubmethodReadBlockAsync(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.

System_CAPS_pubmethodReadLine()

Lee una línea de caracteres del lector de texto y devuelve los datos como una cadena.

System_CAPS_pubmethodReadLineAsync()

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

System_CAPS_pubmethodReadToEnd()

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

System_CAPS_pubmethodReadToEndAsync()

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.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(TextReader)

Crea un contenedor seguro para subprocesos en torno al TextReader especificado.

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object.)

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticNull

Proporciona un TextReader sin datos del que leer.

TextReader es la clase base abstracta de StreamReader y StringReader, que leen caracteres de secuencias y cadenas, respectivamente. Utilice estas clases derivadas para abrir un archivo de texto para leer un intervalo especificado de caracteres, o para crear un lector basado en una secuencia existente.

System_CAPS_importantImportante

Este tipo implementa la IDisposable interfaz. Cuando haya terminado de utilizar cualquier tipo que se deriva este tipo, debería eliminar, directa o indirectamente. Para deshacerse del tipo directamente, llame a su Dispose método en un try/catch bloque. Para deshacerse de él indirectamente, usar una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, consulte Dispose y la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

Notas para los herederos:

Una clase derivada debe implementar la Peek y Read métodos para crear una instancia útil de TextReader.

La clase TextReader es abstracta. Por lo tanto, no inicializarlo en el código. La StreamReader clase se deriva de TextReader y proporciona implementaciones de los miembros para leer desde una secuencia. En el ejemplo siguiente se muestra cómo leer todos los caracteres de un archivo utilizando la StreamReader.ReadAsync(Char[], Int32, Int32) (método). Comprueba si cada carácter es una letra, un dígito o un espacio en blanco antes de agregar el carácter a una instancia de la StringBuilder clase.

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

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click_1(object sender, RoutedEventArgs e)
        {
            string filename = @"C:\Example\existingfile.txt";
            char[] result;
            StringBuilder builder = new StringBuilder();

            using (StreamReader reader = File.OpenText(filename))
            {
                result = new char[reader.BaseStream.Length];
                await reader.ReadAsync(result, 0, (int)reader.BaseStream.Length);
            }

            foreach (char c in result)
            {
                if (char.IsLetterOrDigit(c) || char.IsWhiteSpace(c))
                {
                    builder.Append(c);
                }
            }
            FileOutput.Text = builder.ToString();
        }
    }
}

Universal Windows Platform
Disponible desde 8
.NET Framework
Disponible desde 1.1
Portable Class Library
Compatible con: portable .NET platforms
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar: