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 StreamWriter

 

Publicado: octubre de 2016

Implementa TextWriter para escribir los caracteres de una secuencia en una codificación determinada.

Para examinar el código fuente de .NET Framework para este tipo, vea la Reference Source.

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

System.Object
  System.MarshalByRefObject
    System.IO.TextWriter
      System.IO.StreamWriter

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

NombreDescripción
System_CAPS_pubmethodStreamWriter(Stream)

Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación UTF-8 y el tamaño de búfer predeterminado.

System_CAPS_pubmethodStreamWriter(Stream, Encoding)

Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación especificada y el tamaño de búfer predeterminado.

System_CAPS_pubmethodStreamWriter(Stream, Encoding, Int32)

Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y el tamaño de búfer especificados.

System_CAPS_pubmethodStreamWriter(Stream, Encoding, Int32, Boolean)

Inicializa una nueva instancia de la clase StreamWriter para la secuencia especificada usando la codificación y tamaño de búfer especificados y, opcionalmente deja abierta la secuencia.

System_CAPS_pubmethodStreamWriter(String)

Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados.

System_CAPS_pubmethodStreamWriter(String, Boolean)

Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.

System_CAPS_pubmethodStreamWriter(String, Boolean, Encoding)

Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación especificada y tamaño de búfer predeterminado. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.

System_CAPS_pubmethodStreamWriter(String, Boolean, Encoding, Int32)

Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado en la ruta de acceso especificada, con la codificación y el tamaño de búfer especificados. Si el archivo ya existe, es posible sobrescribirlo o anexarle datos. Si el archivo no existe, este constructor crea uno nuevo.

NombreDescripción
System_CAPS_pubpropertyAutoFlush

Obtiene o establece un valor que indica si StreamWriter vaciará su búfer en la secuencia subyacente después de cada llamada a StreamWriter.Write.

System_CAPS_pubpropertyBaseStream

Obtiene la secuencia subyacente que interactúa con una memoria auxiliar.

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 actual objeto StreamWriter 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 StreamWriter 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 la secuencia subyacente.(Invalida TextWriter.Flush()).

System_CAPS_pubmethodFlushAsync()

Borra todos los búferes para esta secuencia de forma asincrónica y hace que los datos almacenados en 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_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 representa al objeto actual. (Heredado de Object).

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 secuencia.(Invalida TextWriter.Write(Char)).

System_CAPS_pubmethodWrite(Char[])

Escribe una matriz de caracteres en la secuencia.(Invalida TextWriter.Write(Char[])).

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia.(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 secuencia.(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 secuencia 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 secuencia de forma asincrónica.(Invalida TextWriter.WriteAsync(Char[], Int32, Int32)).

System_CAPS_pubmethodWriteAsync(String)

Escribe una cadena en la secuencia de forma asincrónica.(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 de forma asincrónica en la secuencia.(Invalida TextWriter.WriteLineAsync()).

System_CAPS_pubmethodWriteLineAsync(Char)

Escribe un carácter seguido de un terminador de línea de forma asincrónica en la secuencia.(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 secuencia.(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 secuencia.(Invalida TextWriter.WriteLineAsync(String)).

NombreDescripción
System_CAPS_protfieldCoreNewLine

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

System_CAPS_pubfieldSystem_CAPS_staticNull

Proporciona un StreamWriter sin memoria auxiliar, en el que se puede escribir pero no se puede leer.

System_CAPS_noteNota

Para ver el código fuente de .NET Framework para este tipo, consulte el Reference Source. Puede examinar el código fuente en línea, descargue la referencia para verla sin conexión y recorrer (incluidas las revisiones y actualizaciones) durante la depuración; see instructions.

StreamWriter está diseñado para la salida de caracteres en una codificación determinada, mientras que las clases derivadas de Stream están diseñadas para entrada y salida de bytes.

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.

StreamWriter el valor predeterminado es mediante una instancia de UTF8Encoding a menos que se especifique lo contrario. Esta instancia de UTF8Encoding se crea sin una marca de orden de bytes (BOM), por lo que su GetPreamble método devuelve una matriz de bytes vacía. La codificación UTF-8 predeterminada para este constructor, produce una excepción en bytes no válidos. Este comportamiento es diferente del comportamiento proporcionado por el objeto de codificación en el Encoding.UTF8 propiedad. Para especificar una lista de materiales y determinar si se produce una excepción en bytes no válidos, use un constructor que acepta un objeto de codificación como un parámetro, como StreamWriter(String, Boolean, Encoding) o StreamWriter.

De forma predeterminada, un StreamWriter no es seguro para la ejecución de subprocesos. Consulte TextWriter.Synchronized para un contenedor seguro para subprocesos.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

En el ejemplo siguiente se muestra cómo utilizar un StreamWriter objeto que se va a escribir un archivo que muestra los directorios en la unidad C y, a continuación, utiliza un StreamReader objeto para leer y mostrar cada nombre de directorio. Es recomendable utilizar estos objetos en un using instrucción para que se eliminen correctamente los recursos no administrados. El using instrucción llama automáticamente a Dispose en el objeto cuando el código que está utilizándolo ha completado. El constructor utilizado en este ejemplo no se admite para su uso en Tienda Windows aplicaciones.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);

                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

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: