TextWriter.Write Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

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

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

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Char[], Int32, Int32)

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

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(String, Object[])

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

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

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

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(String, Object)

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

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

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

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(UInt64)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(UInt32)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(StringBuilder)

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.

Write(String)

Source:

TextWriter.cs

Escribe una cadena en la secuencia de texto.

public:
 virtual void Write(System::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

• Write(String)
• Write(String)
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Single)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(String, Object, Object)

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

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

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

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Object)

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

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Int64)

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

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Double)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Decimal)

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

• StreamWriter
• StringWriter
• IFormatProvider
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Char[])

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

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

• Write(Char[])
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Char)

Source:

TextWriter.cs

Escribe un carácter en la secuencia de texto.

public:
 virtual void Write(char value);

public virtual void Write (char value);

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

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

• Write(Char)
• Write(Char)
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(Boolean)

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

• StreamWriter
• StringWriter
• de E/S de flujo y archivos
• Cómo: Leer texto de un de archivos
• Cómo: Escribir texto en un archivo

Write(ReadOnlySpan<Char>)

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.