TextWriter.Write Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.IO.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe datos en una secuencia de texto.

Sobrecargas

Write(String, Object, Object, Object)	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Escribe una subbarra de caracteres en la secuencia de texto.
Write(String, ReadOnlySpan<Object>)	Escribe una cadena con formato en la secuencia de texto, con la misma semántica que Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object[]).
Write(String, Object)	Escribe una cadena con formato en la secuencia de texto, utilizando la misma semántica que el método Format(String, Object).
Write(UInt64)	Escribe la representación de texto de un entero de 8 bytes sin signo en la secuencia de texto.
Write(UInt32)	Escribe la representación de texto de un entero de 4 bytes sin signo en la secuencia de texto.
Write(StringBuilder)	Escribe un generador de cadenas en la secuencia de texto.
Write(String)	Escribe una cadena en la secuencia de texto.
Write(Single)	Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.
Write(String, Object, Object)	Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object).
Write(Object)	Escribe la representación de texto de un objeto en la secuencia de texto llamando al método `ToString` en ese objeto.
Write(Int64)	Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.
Write(Int32)	Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.
Write(Double)	Escribe la representación de texto de un valor de punto flotante de 8 bytes en la secuencia de texto.
Write(Decimal)	Escribe la representación de texto de un valor decimal en la secuencia de texto.
Write(Char[])	Escribe una matriz de caracteres en la secuencia de texto.
Write(Char)	Escribe un carácter en la secuencia de texto.
Write(Boolean)	Escribe la representación de texto de un valor de `Boolean` en la secuencia de texto.
Write(ReadOnlySpan<Char>)	Escribe un intervalo de caracteres en la secuencia de texto.

Write(String, Object, Object, Object)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

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

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

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

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.

Excepciones

ArgumentNullException

format es null.

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

FormatException

format no es una cadena de formato compuesto válida.

-o-

El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga de método, es tres).

Comentarios

Este método usa formato compuesto para convertir el valor de un objeto en su representación de cadena e insertar esa representación en una cadena. .NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes:

Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.

El parámetro format consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.

La sintaxis de un elemento de formato es la siguiente:

{de índice [,longitud][:formatString]}

Los elementos entre corchetes son opcionales. En la tabla siguiente se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formato compuesto.

Elemento	Descripción
índice	Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es `null`, el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene tres objetos en su lista de parámetros, el valor de índice debe ser siempre 0, 1 o 2. Si no hay ningún parámetro en la posición índice de , se produce un .
,longitud	Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda.
:formatString	Cadena de formato estándar o personalizada compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método `ToString(string format)` del objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la interfaz IFormattable, se pasa `null` como valor del parámetro `format` que se usa como cadena de formato IFormattable.ToString.

Se requieren los caracteres de llave inicial y final, "{" y "}". Para especificar un único carácter de llave literal en format, especifique dos caracteres de llave inicial o final; es decir, "{{" o "}}".

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.

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 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.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char[], Int32, Int32)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe una subbarra de caracteres en la secuencia de texto.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

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

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Parámetros

buffer: Char[]

Matriz de caracteres desde la que se van a escribir datos.

index: Int32

Posición del carácter en el búfer en el que se van a empezar a recuperar datos.

count: Int32

Número de caracteres que se van a escribir.

Excepciones

ArgumentException

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

ArgumentNullException

El parámetro buffer es null.

ArgumentOutOfRangeException

index o count es negativo.

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

Este método escribirá count caracteres de datos en este TextWriter desde la matriz de caracteres de buffer a partir de la posición index.

Esta sobrecarga es equivalente a la sobrecarga de Write(Char[]) para cada carácter de buffer entre index y (index + count).

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 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 de texto, con la misma semántica que Format(String, ReadOnlySpan<Object>).

public:
 virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

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

abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit

Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))

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:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

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

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

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

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.

Excepciones

ArgumentNullException

format o arg es null.

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

FormatException

format no es una cadena de formato compuesto válida.

-o-

El índice de un elemento de formato es menor que 0 (cero) o mayor o igual que la longitud de la matriz de arg.

Comentarios

Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.

La sintaxis de un elemento de formato es la siguiente:

{de índice [,longitud][:formatString]}

Elemento	Descripción
índice	Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es `null`, el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene una matriz en su lista de parámetros, el valor de índice siempre debe ser menor que la longitud de la matriz. Si no hay ningún parámetro en la posición índice de , se produce un .
,longitud	Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda.
:formatString	Cadena de formato estándar o personalizada compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método `ToString(string format)` del objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la interfaz IFormattable, se pasa `null` como valor del parámetro `format` que se usa como cadena de formato IFormattable.ToString.

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.

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 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:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object arg0);

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

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Parámetros

format: String

Cadena de formato compuesto.

arg0: Object

Objeto al que se va a dar formato y escribir.

Excepciones

ArgumentNullException

format es null.

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

FormatException

format no es una cadena de formato compuesto válida.

-o-

El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga de método, es uno).

Comentarios

Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.

La sintaxis de un elemento de formato es la siguiente:

{de índice [,longitud][:formatString]}

Elemento	Descripción
índice	Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es `null`, el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga solo tiene un solo objeto en su lista de parámetros, el valor de índice siempre debe ser 0. Si no hay ningún parámetro en la posición índice de , se produce un .
,longitud	Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda.
:formatString	Cadena de formato estándar o personalizada compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método `ToString(string format)` del objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la interfaz IFormattable, se pasa `null` como valor del parámetro `format` que se usa como cadena de formato IFormattable.ToString.

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.

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 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.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(UInt64)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero de 8 bytes sin signo en la secuencia de texto.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Parámetros

value: UInt64

Entero de 8 bytes sin signo que se va a escribir.

Atributos: CLSCompliantAttribute

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método UInt64.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero de 4 bytes sin signo en la secuencia de texto.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Parámetros

value: UInt32

Entero de 4 bytes sin signo que se va a escribir.

Atributos: CLSCompliantAttribute

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método UInt32.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe un generador de cadenas en la secuencia de texto.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Parámetros

value: StringBuilder

Cadena, como generador de cadenas, para escribir en la secuencia de texto.

Comentarios

Este método es equivalente a Write(stringBuilder.ToString()), pero usa el método StringBuilder.GetChunks para evitar crear la cadena intermedia.

Se aplica a

.NET 9 otras versiones

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

Write(String)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe una cadena en la secuencia de texto.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Parámetros

value: String

Cadena que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

Esta sobrecarga es equivalente a la sobrecarga de Write(Char[]).

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.

Si value es null, no se escribe nada en la secuencia de texto.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Parámetros

value: Single

Valor de punto flotante de 4 bytes que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método Single.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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 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, Object)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

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

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

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

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.

Excepciones

ArgumentNullException

format es null.

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

FormatException

format no es una cadena de formato compuesto válida.

-o-

El índice de un elemento de formato es menor que 0 (cero) o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga de método, es dos).

Comentarios

Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.

La sintaxis de un elemento de formato es la siguiente:

{de índice [,longitud][:formatString]}

Elemento	Descripción
índice	Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es `null`, el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene dos objetos en su lista de parámetros, el valor de índice siempre debe ser 0 o 1. Si no hay ningún parámetro en la posición índice de , se produce un .
,longitud	Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda.
:formatString	Cadena de formato estándar o personalizada compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método `ToString(string format)` del objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la interfaz IFormattable, se pasa `null` como valor del parámetro `format` que se usa como cadena de formato IFormattable.ToString.

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.

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 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.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Object)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un objeto en la secuencia de texto llamando al método ToString en ese objeto.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Parámetros

value: Object

Objeto que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

Esta sobrecarga es equivalente a la sobrecarga de Write(String).

Si el objeto especificado es null, no se realiza ninguna acción y no se produce ninguna excepción. De lo contrario, se llama al método ToString del objeto para generar la representación de cadena y, a continuación, se escribe la cadena resultante en el flujo de salida. La propiedad FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Parámetros

value: Int64

Entero de 8 bytes con signo que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método Int64.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Cómo: Escribir texto en un archivo

Consulte también

Se aplica a

.NET 9 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(Int32)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Parámetros

value: Int32

Entero de 4 bytes con signo que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método Int32.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un valor de punto flotante de 8 bytes en la secuencia de texto.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Parámetros

value: Double

Valor de punto flotante de 8 bytes que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método Double.ToString. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un valor decimal en la secuencia de texto.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Parámetros

value: Decimal

Valor decimal que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La propiedad FormatProvider, si no null, especifica el formato específico de la referencia cultural.

Consulte también

Se aplica a

.NET 9 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:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe una matriz de caracteres en la secuencia de texto.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[] buffer);

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

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Parámetros

buffer: Char[]

Matriz de caracteres que se va a escribir en la secuencia de texto.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

Este método no busca en la cadena especificada los caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por NewLine.

Este método predeterminado llama al método Write(Char[], Int32, Int32) y pasa toda la matriz de caracteres. Si la matriz de caracteres es null, no se escribe nada.

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 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:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe un carácter en la secuencia de texto.

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

abstract member Write : char -> unit
override this.Write : char -> unit

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

Parámetros

value: Char

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

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

Este método predeterminado no hace nada, pero las clases derivadas pueden invalidar el método para proporcionar la funcionalidad adecuada.

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

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe la representación de texto de un valor de Boolean en la secuencia de texto.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Parámetros

value: Boolean

Valor de Boolean que se va a escribir.

Excepciones

ObjectDisposedException

El TextWriter está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La representación de texto del valor especificado se genera llamando al método Boolean.ToString.

Este método genera Boolean.TrueString o Boolean.FalseString.

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 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(ReadOnlySpan<Char>)

Source:: TextWriter.cs

Source:: TextWriter.cs

Source:: TextWriter.cs

Escribe un intervalo de caracteres en la secuencia de texto.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

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

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Parámetros

buffer: ReadOnlySpan<Char>

Intervalo de caracteres que se va a escribir.

Comentarios

La representación de texto del valor especificado se genera llamando al ReadOnlySpan<Char>. Método toString.

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

Se aplica a

.NET 9 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

Compartir vía

TextWriter.Write Método

Definición

Sobrecargas

Write(String, Object, Object, Object)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(Char[], Int32, Int32)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(String, ReadOnlySpan<Object>)

Parámetros

Se aplica a

Write(String, Object[])

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(String, Object)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(UInt64)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(UInt32)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(StringBuilder)

Parámetros

Comentarios

Se aplica a

Write(String)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(Single)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(String, Object, Object)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(Object)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(Int64)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(Int32)

Parámetros

Excepciones