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

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:

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

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

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

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

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:

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

Se aplica a

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

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:

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

Se aplica a

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

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

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

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

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

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

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:

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

Se aplica a

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

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

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

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

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

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

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

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

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