StreamWriter.Write Método

Definición

Escribe datos en la secuencia.

Sobrecargas

Write(String, Object, Object, Object)

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

Write(String, Object, Object)

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

Write(Char[], Int32, Int32)

Escribe una subbarra de caracteres en la secuencia.

Write(String, ReadOnlySpan<Object>)

Escribe una cadena con formato en la secuencia, con la misma semántica que Format(String, ReadOnlySpan<Object>).

Write(String, Object[])

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

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia.

Write(String)

Escribe una cadena en la secuencia.

Write(Char[])

Escribe una matriz de caracteres en la secuencia.

Write(Char)

Escribe un carácter en la secuencia.

Write(String, Object)

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

Write(String, Object, Object, Object)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

public override void Write (string format, object? arg0, object? arg1, object? arg2);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Primer objeto al que se va a dar formato y escribir.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.

arg2
Object

Tercer objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object, Object, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(String, Object, Object)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

public override void Write (string format, object? arg0, object? arg1);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Primer objeto al que se va a dar formato y escribir.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(Char[], Int32, Int32)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Escribe una subbarra de caracteres en la secuencia.

public override void Write (char[] buffer, int index, int count);

Parámetros

buffer
Char[]

Matriz de caracteres que contiene los datos que se van a escribir.

index
Int32

Posición del carácter en el búfer en el que se empiezan a leer los datos.

count
Int32

Número máximo de caracteres que se van a escribir.

Excepciones

buffer es null.

La longitud del búfer menos index es menor que count.

index o count es negativo.

Se produce un error de E/S.

AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.

AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.

Ejemplos

En este ejemplo se escriben ocho caracteres de una matriz de 13 elementos en un archivo, comenzando en el tercer elemento de la matriz.

using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}

Comentarios

Este método invalida TextWriter.Write.

Los caracteres se leen desde buffer a partir de index y continúan a través de index + (count - 1). Todos los caracteres se escriben en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia subyacente. Flush se invoca automáticamente si AutoFlush es true.

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

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(String, ReadOnlySpan<Object>)

Escribe una cadena con formato en la secuencia, con la misma semántica que Format(String, ReadOnlySpan<Object>).

public override void Write (string format, scoped ReadOnlySpan<object?> arg);

Parámetros

format
String

Cadena de formato compuesto.

arg
ReadOnlySpan<Object>

Intervalo de objetos que contiene cero o más objetos para dar formato y escribir.

Se aplica a

.NET 9
Producto Versiones
.NET 9

Write(String, Object[])

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

public override void Write (string format, params object?[] arg);

Parámetros

format
String

Cadena de formato compuesto.

arg
Object[]

Matriz de objetos que contiene cero o más objetos para dar formato y escribir.

Comentarios

Consulte Write(String, Object[]) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(ReadOnlySpan<Char>)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Escribe un intervalo de caracteres en la secuencia.

public override void Write (ReadOnlySpan<char> buffer);

Parámetros

buffer
ReadOnlySpan<Char>

Intervalo de caracteres que se va a escribir.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Write(String)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Escribe una cadena en la secuencia.

public override void Write (string value);
public override void Write (string? value);

Parámetros

value
String

Cadena que se va a escribir en la secuencia. Si value es NULL, no se escribe nada.

Excepciones

AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.

AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.

Se produce un error de E/S.

Comentarios

Este método invalida TextWriter.Write.

El String especificado se escribe en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia.

Flush se invoca automáticamente si AutoFlush es true. Si value es null, no se escribe ninguna entrada.

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

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(Char[])

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Escribe una matriz de caracteres en la secuencia.

public override void Write (char[] buffer);
public override void Write (char[]? buffer);

Parámetros

buffer
Char[]

Matriz de caracteres que contiene los datos que se van a escribir. Si buffer es null, no se escribe nada.

Excepciones

Se produce un error de E/S.

AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.

AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.

Comentarios

Este método invalida TextWriter.Write.

Los caracteres especificados se escriben en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia. Si AutoFlush es true, se invoca automáticamente Flush.

Este método puede proporcionar un rendimiento más rápido que Write (char[],``int,``int) porque tiene menos argumentos que comprobar.

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

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(Char)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Escribe un carácter en la secuencia.

public override void Write (char value);

Parámetros

value
Char

Carácter que se va a escribir en la secuencia.

Excepciones

Se produce un error de E/S.

AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.

AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.

Comentarios

Este método invalida TextWriter.Write.

El carácter especificado se escribe en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia. Si AutoFlush es true, se invoca automáticamente Flush.

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

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(String, Object)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

public override void Write (string format, object? arg0);

Parámetros

format
String

Cadena de formato compuesto.

arg0
Object

Objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9