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

Clase StringWriter

 

Publicado: octubre de 2016

Implementa un TextWriter para escribir información en una cadena. La información se almacena en un StringBuilder subyacente.

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

System.Object
  System.MarshalByRefObject
    System.IO.TextWriter
      System.IO.StringWriter

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class StringWriter : TextWriter

NombreDescripción
System_CAPS_pubmethodStringWriter()

Inicializa una nueva instancia de la clase StringWriter.

System_CAPS_pubmethodStringWriter(IFormatProvider)

Inicializa una nueva instancia de la clase StringWriter con el control de formato especificado.

System_CAPS_pubmethodStringWriter(StringBuilder)

Inicializa una nueva instancia de la clase StringWriter que escribe en el elemento StringBuilder especificado.

System_CAPS_pubmethodStringWriter(StringBuilder, IFormatProvider)

Inicializa una nueva instancia de la clase StringWriter que escribe en el StringBuilder especificado y tiene el proveedor de formato especificado.

NombreDescripción
System_CAPS_pubpropertyEncoding

Obtiene el Encoding donde se escribe el resultado.(Invalida TextWriter.Encoding).

System_CAPS_pubpropertyFormatProvider

Obtiene un objeto que controla las operaciones de formato.(Heredado de TextWriter).

System_CAPS_pubpropertyNewLine

Obtiene o establece la cadena de terminador de línea usada por el TextWriter actual.(Heredado de TextWriter).

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el StringWriter actual y la secuencia subyacente.(Invalida TextWriter.Close()).

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

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa StringWriter y libera los recursos administrados de forma opcional.(Invalida TextWriter.Dispose(Boolean)).

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_pubmethodFlush()

Borra todos los búferes del sistema de escritura actual y hace que todos los datos almacenados en el búfer se escriban en el dispositivo subyacente.(Heredado de TextWriter).

System_CAPS_pubmethodFlushAsync()

Borra asincrónicamente todos los búferes del sistema de escritura actual y hace que todos los datos almacenados en el búfer se escriban en el dispositivo subyacente.(Invalida TextWriter.FlushAsync()).

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_pubmethodGetStringBuilder()

Devuelve el StringBuilder subyacente.

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_pubmethodToString()

Devuelve una cadena que contiene los caracteres escritos en el StringWriter actual hasta ahora.(Invalida Object.ToString()).

System_CAPS_pubmethodWrite(Boolean)

Escribe la representación de texto de un valor Boolean en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Char)

Escribe un carácter en la cadena.(Invalida TextWriter.Write(Char)).

System_CAPS_pubmethodWrite(Char[])

Escribe una matriz de caracteres en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la cadena.(Invalida TextWriter.Write(Char[], Int32, Int32)).

System_CAPS_pubmethodWrite(Decimal)

Escribe la representación de texto de un valor decimal en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Object)

Escribe la representación de texto de un objeto en la cadena o secuencia de texto mediante una llamada al método ToString en ese objeto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(String)

Escribe una cadena en la cadena actual.(Invalida TextWriter.Write(String)).

System_CAPS_pubmethodWrite(String, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object).(Heredado de TextWriter).

System_CAPS_pubmethodWrite(String, Object, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object, Object).(Heredado de TextWriter).

System_CAPS_pubmethodWrite(String, Object, Object, Object)

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object, Object, Object).(Heredado de TextWriter).

System_CAPS_pubmethodWrite(String, Object[])

Escribe una cadena con formato en la cadena de texto o en la secuencia, con la misma semántica que el método de String.Format(String, Object[]).(Heredado de TextWriter).

System_CAPS_pubmethodWrite(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWrite(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteAsync(Char)

Escribe un carácter en la cadena de forma asincrónica.(Invalida TextWriter.WriteAsync(Char)).

System_CAPS_pubmethodWriteAsync(Char[])

Escribe una matriz de caracteres en la cadena o secuencia de texto de forma asincrónica.(Heredado de TextWriter).

System_CAPS_pubmethodWriteAsync(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la cadena de forma asincrónica.(Invalida TextWriter.WriteAsync(Char[], Int32, Int32)).

System_CAPS_pubmethodWriteAsync(String)

Escribe una cadena en la cadena actual.(Invalida TextWriter.WriteAsync(String)).

System_CAPS_pubmethodWriteLine()

Escribe un terminador de línea en la cadena o secuencia.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Boolean)

Escribe la representación de texto de un valor Boolean seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Char)

Escribe un carácter seguido de un terminador en la cadena o la secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Decimal)

Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Object)

Escribe la representación de texto de un objeto mediante una llamada al método ToString en ese objeto, seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(String)

Escribe una cadena seguida de un terminador en la cadena o la secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(String, Object)

Escribe una cadena con formato y una nueva línea en la cadena de texto o a la secuencia, con la misma semántica que el método de String.Format(String, Object).(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(String, Object, Object)

Escribe una cadena con formato y una nueva línea en la cadena de texto o a la secuencia, con la misma semántica que el método de String.Format(String, Object, Object).(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(String, Object, Object, Object)

Escribe una cadena con formato y una nueva línea usando la misma semántica que Format.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(String, Object[])

Escribe una cadena con formato y una nueva línea usando la misma semántica que Format.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLine(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes seguida de un terminador de línea en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLineAsync()

Escribe un terminador de línea en la cadena o secuencia de forma asincrónica.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLineAsync(Char)

Escribe un carácter seguido de un terminador de línea de forma asincrónica en la cadena.(Invalida TextWriter.WriteLineAsync(Char)).

System_CAPS_pubmethodWriteLineAsync(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena o secuencia de texto.(Heredado de TextWriter).

System_CAPS_pubmethodWriteLineAsync(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena.(Invalida TextWriter.WriteLineAsync(Char[], Int32, Int32)).

System_CAPS_pubmethodWriteLineAsync(String)

Escribe una cadena seguida de un terminador de línea de forma asincrónica en la cadena actual.(Invalida TextWriter.WriteLineAsync(String)).

NombreDescripción
System_CAPS_protfieldCoreNewLine

Almacena los caracteres de nueva línea usados para el TextWriter.(Heredado de TextWriter).

StringWriter permite escribir en una cadena de forma sincrónica o asincrónica. Puede escribir un carácter a la vez con el Write(Char) o WriteAsync(Char) (método), una cadena en un momento mediante el Write(String) o WriteAsync(String) (método). Además, puede escribir un carácter, una matriz de caracteres o una cadena seguida del terminador de línea de forma asincrónica con uno de los WriteLineAsync métodos.

System_CAPS_importantImportante

Este tipo implementa la IDisposable interfaz. Cuando haya terminado de utilizar el 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 la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

En la tabla siguiente se muestra 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

Leer de 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

Obtener el tamaño de un archivo.

FileInfo.Length

Obtener los atributos de un archivo.

File.GetAttributes

Establezca los atributos de un archivo.

File.SetAttributes

Determinar si existe un archivo.

File.Exists

Leer de 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

En el ejemplo de código siguiente se muestra la creación de un párrafo continuo de un grupo de frases a doble espacio y, a continuación, la conversión del párrafo al texto original.

using System;
using System.IO;

class StringRW
{
    static void Main()
    {
        string textReaderText = "TextReader is the abstract base " +
            "class of StreamReader and StringReader, which read " +
            "characters from streams and strings, respectively.\n\n" +

            "Create an instance of TextReader to open a text file " +
            "for reading a specified range of characters, or to " +
            "create a reader based on an existing stream.\n\n" +

            "You can also use an instance of TextReader to read " +
            "text from a custom backing store using the same " +
            "APIs you would use for a string or a stream.\n\n";

        Console.WriteLine("Original text:\n\n{0}", textReaderText);

        // From textReaderText, create a continuous paragraph 
        // with two spaces between each sentence.
        string aLine, aParagraph = null;
        StringReader strReader = new StringReader(textReaderText);
        while(true)
        {
            aLine = strReader.ReadLine();
            if(aLine != null)
            {
                aParagraph = aParagraph + aLine + " ";
            }
            else
            {
                aParagraph = aParagraph + "\n";
                break;
            }
        }
        Console.WriteLine("Modified text:\n\n{0}", aParagraph);

        // Re-create textReaderText from aParagraph.
        int intCharacter;
        char convertedCharacter;
        StringWriter strWriter = new StringWriter();
        strReader = new StringReader(aParagraph);
        while(true)
        {
            intCharacter = strReader.Read();

            // Check for the end of the string 
            // before converting to a character.
            if(intCharacter == -1) break;

            convertedCharacter = Convert.ToChar(intCharacter);
            if(convertedCharacter == '.')
            {
                strWriter.Write(".\n\n");

                // Bypass the spaces between sentences.
                strReader.Read();
                strReader.Read();
            }
            else
            {
                strWriter.Write(convertedCharacter);
            }
        }
        Console.WriteLine("\nOriginal text:\n\n{0}", 
            strWriter.ToString());
    }
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: