Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

StreamWriter (Clase)

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

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

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

El tipo StreamWriter expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStreamWriter(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.
Método públicoCompatible con XNA FrameworkStreamWriter(String)Inicializa una nueva instancia de la clase StreamWriter para el archivo especificado usando la codificación y tamaño de búfer especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStreamWriter(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.
Método públicoCompatible con XNA FrameworkStreamWriter(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 sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStreamWriter(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.
Método públicoCompatible con XNA FrameworkStreamWriter(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 sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsStreamWriter(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.
Método públicoCompatible con XNA FrameworkStreamWriter(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 sobrescribir o anexar datos al mismo. Si el archivo no existe, este constructor crea uno nuevo.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAutoFlushObtiene o establece un valor que indica si StreamWriter vaciará su búfer en la secuencia subyacente después de cada llamada a StreamWriter.Write.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsBaseStreamObtiene la secuencia subyacente que interactúa con una memoria auxiliar.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEncodingObtiene el Encoding donde se escribe el resultado. (Invalida a TextWriter.Encoding).
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFormatProviderObtiene un objeto que controla las operaciones de formato. (Se hereda de TextWriter).
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNewLineObtiene o establece la cadena de terminador de línea utilizada por el TextWriter actual. (Se hereda de TextWriter).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloseCierra el actual objeto StreamWriter y la secuencia subyacente. (Invalida a TextWriter.Close()).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose()Libera todos los recursos utilizados por el objeto TextWriter. (Se hereda de TextWriter).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose(Boolean)Libera los recursos no administrados que utiliza StreamWriter y libera los recursos administrados de forma opcional. (Invalida a TextWriter.Dispose(Boolean)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFlushBorra 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 a TextWriter.Flush()).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsFlushAsyncBorra todos los búferes para este flujo de forma asincrónica y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente. (Invalida a TextWriter.FlushAsync()).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Boolean)Escribe la representación de texto de un valor Boolean en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Char)Escribe un carácter en la secuencia. (Invalida a TextWriter.Write(Char)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Char[])Escribe una matriz de caracteres en la secuencia. (Invalida a TextWriter.Write(Char[])).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Decimal)Escribe la representación de texto de un valor decimal en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Double)Escribe la representación de texto de un valor de punto flotante de 8 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Int32)Escribe la representación de texto de un entero con signo de 4 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Int64)Escribe la representación de texto de un entero con signo de 8 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Single)Escribe la representación de texto de un valor de punto flotante de 4 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(String)Escribe una cadena en la secuencia. (Invalida a TextWriter.Write(String)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(UInt32)Escribe la representación de texto de un entero sin signo de 4 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(UInt64)Escribe la representación de texto de un entero sin signo de 8 bytes en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWrite(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) . (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(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[]) . (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWrite(Char[], Int32, Int32)Escribe una submatriz de caracteres en la secuencia. (Invalida a TextWriter.Write(Char[], Int32, Int32)).
Método públicoCompatible con XNA FrameworkWrite(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) . (Se hereda de TextWriter).
Método públicoWrite(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) . (Se hereda de TextWriter).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAsync(Char)Escribe una matriz de caracteres en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteAsync(Char)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAsync(Char[])Escribe una matriz de caracteres en la cadena o secuencia de texto de forma asincrónica. (Se hereda de TextWriter).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAsync(String)Escribe una cadena en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteAsync(String)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAsync(Char[], Int32, Int32)Escribe una submatriz de caracteres en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteAsync(Char[], Int32, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine()Escribe un terminador de línea en la cadena o secuencia. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(Char)Escribe un carácter seguido de un terminador en la cadena o la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(Char[])Escribe una matriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(String)Escribe una cadena seguida de un terminador en la cadena o la secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(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. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWriteLine(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) . (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(String, Object[])Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(Char[], Int32, Int32)Escribe una submatriz de caracteres seguida de un terminador de línea en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con XNA FrameworkWriteLine(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) . (Se hereda de TextWriter).
Método públicoWriteLine(String, Object, Object, Object)Escribe una cadena con formato y una nueva línea utilizando la misma semántica que Format. (Se hereda de TextWriter).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineAsync()Escribe un terminador de línea en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteLineAsync()).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineAsync(Char)Escribe un carácter seguido de un terminador de forma asincrónica de línea en la secuencia. (Invalida a TextWriter.WriteLineAsync(Char)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineAsync(Char[])Escribe una matriz de caracteres seguida de un terminador de línea de forma asincrónica en la cadena o secuencia de texto. (Se hereda de TextWriter).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineAsync(String)Escribe una cadena seguida de un terminador de línea en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteLineAsync(String)).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineAsync(Char[], Int32, Int32)Escribe una submatriz de caracteres seguida de un terminador de línea en la secuencia de forma asincrónica. (Invalida a TextWriter.WriteLineAsync(Char[], Int32, Int32)).
Arriba

  NombreDescripción
Campo protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCoreNewLineAlmacena los caracteres de nueva línea usados para el TextWriter. (Se hereda de TextWriter).
Campo públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNullProporciona un objeto StreamWriter sin memoria auxiliar, en el que se puede escribir pero no se puede leer.
Arriba

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

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

De forma predeterminada, StreamWriter no es seguro para el uso de subprocesos. Para obtener un contenedor seguro para subprocesos, vea TextWriter.Synchronized.

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

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


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);
                }
            }
        }
    }
}


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft