TextWriter.Write Método

Definición

Escribe datos en una secuencia de texto.Writes data to a text stream.

Sobrecargas

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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia de texto.Writes a subarray of characters to the text stream.

Write(String, Object[])

Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object)

Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

Escribe un generador de cadenas en la secuencia de texto.Writes a string builder to the text stream.

Write(String)

Escribe una cadena en la secuencia de texto.Writes a string to the text stream.

Write(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, 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, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object)

Escribe la representación de texto de un objeto en la secuencia de texto mediante una llamada al método ToString en ese objeto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

Escribe la representación de texto de un punto flotante de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

Escribe la representación de texto de un valor decimal en la secuencia de texto.Writes the text representation of a decimal value to the text stream.

Write(Char[])

Escribe una matriz de caracteres en la secuencia de texto.Writes a character array to the text stream.

Write(Char)

Escribe un carácter en la secuencia de texto.Writes a character to the text stream.

Write(Boolean)

Escribe la representación de texto de un valor Boolean en la secuencia de texto.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia de texto.Writes a character span to the text stream.

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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

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.A composite format string.

arg0
Object

Primer objeto al que se va a dar formato y escribir.The first object to format and write.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.The second object to format and write.

Excepciones

format es null.format is null.

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

format no es una cadena de formato compuesta.format is not a valid composite format string.

o bien-or- 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 del método, es dos).The index of a format item is less than 0 (zero) or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

Comentarios

Este método usa formatos compuestos para convertir el valor de un objeto en su representación de cadena e incrustar esa representación en una cadena.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El format parámetro se compone de cero o más ejecuciones de texto combinadas con cero o más marcadores de posición indizados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. El proceso de formato reemplaza cada elemento de formato con la representación de cadena del valor del objeto correspondiente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintaxis de un elemento de formato es la siguiente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Los elementos entre corchetes son opcionales.Elements in square brackets are optional. En esta tabla se describe cada elemento.The following table describes each element. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea formato compuesto.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescripciónDescription
índiceindex Posición de base cero en la lista de parámetros del objeto al que se va a dar formato.The zero-based position in the parameter list of the object to be formatted. Si el objeto especificado por index es null , el elemento de formato se reemplaza por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Dado que esta sobrecarga tiene dos objetos en su lista de parámetros, el valor de index siempre debe ser 0 o 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Si no hay ningún parámetro en la posición de Índice , FormatException se produce una excepción.If there is no parameter in the index position, a FormatException is thrown.
,longitud,length Número mínimo de caracteres en la representación de cadena del parámetro.The minimum number of characters in the string representation of the parameter. Si es positivo, el parámetro está alineado a la derecha; Si es negativo, se alinea a la izquierda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Una cadena de formato estándar o personalizado que es compatible con el objeto al que se va a dar formato.A standard or custom format string that is supported by the object to be formatted. Los valores posibles para FormatString son los mismos que los que admite el método del objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Si no se especifica FormatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se utiliza como la IFormattable.ToString cadena de formato.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Los caracteres de llave iniciales y finales, "{" y "}", son obligatorios.The leading and trailing brace characters, "{" and "}", are required. Para especificar un único carácter de llave literal en format , especifique dos caracteres de llave iniciales o finales; es decir, "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.If a specified object is not referenced in the format string, it is ignored.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia de texto.Writes a subarray of characters to the text stream.

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 de la que se escriben los datos.The character array to write data from.

index
Int32

Posición del carácter en el búfer donde comenzar la recuperación de datos.The character position in the buffer at which to start retrieving data.

count
Int32

Número de caracteres que se van a escribir.The number of characters to write.

Excepciones

La longitud del búfer menos index es menor que count.The buffer length minus index is less than count.

El parámetro buffer es null.The buffer parameter is null.

index o count es negativo.index or count is negative.

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

Este método escribirá count los caracteres de datos en este TextWriter desde la matriz de caracteres a partir de la buffer posición index .This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Esta sobrecarga es equivalente a la Write(Char[]) sobrecarga de cada carácter buffer entre index y ( index + count ).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(String, Object[])

Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

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.A composite format string.

arg
Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato y escribir.An object array that contains zero or more objects to format and write.

Excepciones

format o arg es null.format or arg is null.

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

format no es una cadena de formato compuesta.format is not a valid composite format string.

o bien-or- El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que la longitud de la matriz arg.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

Comentarios

Este método usa formatos compuestos para convertir el valor de un objeto en su representación de cadena e incrustar esa representación en una cadena.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El format parámetro se compone de cero o más ejecuciones de texto combinadas con cero o más marcadores de posición indizados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. El proceso de formato reemplaza cada elemento de formato con la representación de cadena del valor del objeto correspondiente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintaxis de un elemento de formato es la siguiente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Los elementos entre corchetes son opcionales.Elements in square brackets are optional. En esta tabla se describe cada elemento.The following table describes each element. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea formato compuesto.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescripciónDescription
índiceindex Posición de base cero en la lista de parámetros del objeto al que se va a dar formato.The zero-based position in the parameter list of the object to be formatted. Si el objeto especificado por index es null , el elemento de formato se reemplaza por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Dado que esta sobrecarga tiene una matriz en su lista de parámetros, el valor de index siempre debe ser menor que la longitud de la matriz.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Si no hay ningún parámetro en la posición de Índice , FormatException se produce una excepción.If there is no parameter in the index position, a FormatException is thrown.
,longitud,length Número mínimo de caracteres en la representación de cadena del parámetro.The minimum number of characters in the string representation of the parameter. Si es positivo, el parámetro está alineado a la derecha; Si es negativo, se alinea a la izquierda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Una cadena de formato estándar o personalizado que es compatible con el objeto al que se va a dar formato.A standard or custom format string that is supported by the object to be formatted. Los valores posibles para FormatString son los mismos que los que admite el método del objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Si no se especifica FormatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se utiliza como la IFormattable.ToString cadena de formato.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Los caracteres de llave iniciales y finales, "{" y "}", son obligatorios.The leading and trailing brace characters, "{" and "}", are required. Para especificar un único carácter de llave literal en format , especifique dos caracteres de llave iniciales o finales; es decir, "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.If a specified object is not referenced in the format string, it is ignored.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(String, Object)

Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

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.A composite format string.

arg0
Object

El objeto al que se va a dar formato y escribir.The object to format and write.

Excepciones

format es null.format is null.

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

format no es una cadena de formato compuesta.format is not a valid composite format string.

o bien-or- 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 del método, es uno).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

Comentarios

Este método usa formatos compuestos para convertir el valor de un objeto en su representación de cadena e incrustar esa representación en una cadena.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El format parámetro se compone de cero o más ejecuciones de texto combinadas con cero o más marcadores de posición indizados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. El proceso de formato reemplaza cada elemento de formato con la representación de cadena del valor del objeto correspondiente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintaxis de un elemento de formato es la siguiente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Los elementos entre corchetes son opcionales.Elements in square brackets are optional. En esta tabla se describe cada elemento.The following table describes each element. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea formato compuesto.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescripciónDescription
índiceindex Posición de base cero en la lista de parámetros del objeto al que se va a dar formato.The zero-based position in the parameter list of the object to be formatted. Si el objeto especificado por index es null , el elemento de formato se reemplaza por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Dado que esta sobrecarga solo tiene un objeto en su lista de parámetros, el valor de index siempre debe ser 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Si no hay ningún parámetro en la posición de Índice , FormatException se produce una excepción.If there is no parameter in the index position, a FormatException is thrown.
,longitud,length Número mínimo de caracteres en la representación de cadena del parámetro.The minimum number of characters in the string representation of the parameter. Si es positivo, el parámetro está alineado a la derecha; Si es negativo, se alinea a la izquierda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Una cadena de formato estándar o personalizado que es compatible con el objeto al que se va a dar formato.A standard or custom format string that is supported by the object to be formatted. Los valores posibles para FormatString son los mismos que los que admite el método del objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Si no se especifica FormatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se utiliza como la IFormattable.ToString cadena de formato.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Los caracteres de llave iniciales y finales, "{" y "}", son obligatorios.The leading and trailing brace characters, "{" and "}", are required. Para especificar un único carácter de llave literal en format , especifique dos caracteres de llave iniciales o finales; es decir, "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.If a specified object is not referenced in the format string, it is ignored.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(UInt64)

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte unsigned integer to the text stream.

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.The 8-byte unsigned integer to write.

Atributos

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al UInt64.ToString método.The text representation of the specified value is produced by calling the UInt64.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(UInt32)

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte unsigned integer to the text stream.

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.The 4-byte unsigned integer to write.

Atributos

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al UInt32.ToString método.The text representation of the specified value is produced by calling the UInt32.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(StringBuilder)

Escribe un generador de cadenas en la secuencia de texto.Writes a string builder to the text stream.

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, que se va a escribir en la secuencia de texto.The string, as a string builder, to write to the text stream.

Comentarios

Este método es equivalente a Write(stringBuilder.ToString()) , pero usa el StringBuilder.GetChunks método para evitar la creación de la cadena intermedia.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Se aplica a

Write(String)

Escribe una cadena en la secuencia de texto.Writes a string to the text stream.

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.The string to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

Esta sobrecarga es equivalente a la Write(Char[]) sobrecarga.This overload is equivalent to the Write(Char[]) overload.

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Si value es null, no se escribirá nada en la secuencia de texto.If value is null, nothing is written to the text stream.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte floating-point value to the text stream.

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.The 4-byte floating-point value to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al Single.ToString método.The text representation of the specified value is produced by calling the Single.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(String, Object, 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, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

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.A composite format string.

arg0
Object

Primer objeto al que se va a dar formato y escribir.The first object to format and write.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.The second object to format and write.

arg2
Object

Tercer objeto al que se va a dar formato y escribir.The third object to format and write.

Excepciones

format es null.format is null.

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

format no es una cadena de formato compuesta.format is not a valid composite format string.

o bien-or- 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 del método, es tres).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

Comentarios

Este método usa formatos compuestos para convertir el valor de un objeto en su representación de cadena e incrustar esa representación en una cadena.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET proporciona una gran compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

El format parámetro se compone de cero o más ejecuciones de texto combinadas con cero o más marcadores de posición indizados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. El proceso de formato reemplaza cada elemento de formato con la representación de cadena del valor del objeto correspondiente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintaxis de un elemento de formato es la siguiente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Los elementos entre corchetes son opcionales.Elements in square brackets are optional. En esta tabla se describe cada elemento.The following table describes each element. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea formato compuesto.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescripciónDescription
índiceindex Posición de base cero en la lista de parámetros del objeto al que se va a dar formato.The zero-based position in the parameter list of the object to be formatted. Si el objeto especificado por index es null , el elemento de formato se reemplaza por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Dado que esta sobrecarga tiene tres objetos en su lista de parámetros, el valor de index siempre debe ser 0, 1 o 2.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Si no hay ningún parámetro en la posición de Índice , FormatException se produce una excepción.If there is no parameter in the index position, a FormatException is thrown.
,longitud,length Número mínimo de caracteres en la representación de cadena del parámetro.The minimum number of characters in the string representation of the parameter. Si es positivo, el parámetro está alineado a la derecha; Si es negativo, se alinea a la izquierda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Una cadena de formato estándar o personalizado que es compatible con el objeto al que se va a dar formato.A standard or custom format string that is supported by the object to be formatted. Los valores posibles para FormatString son los mismos que los que admite el método del objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Si no se especifica FormatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se utiliza como la IFormattable.ToString cadena de formato.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Los caracteres de llave iniciales y finales, "{" y "}", son obligatorios.The leading and trailing brace characters, "{" and "}", are required. Para especificar un único carácter de llave literal en format , especifique dos caracteres de llave iniciales o finales; es decir, "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.If a specified object is not referenced in the format string, it is ignored.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Object)

Escribe la representación de texto de un objeto en la secuencia de texto mediante una llamada al método ToString en ese objeto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

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.The object to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

Esta sobrecarga es equivalente a la Write(String) sobrecarga.This overload is equivalent to the Write(String) overload.

Si el objeto especificado es null , no se realiza ninguna acción y no se produce ninguna excepción.If the specified object is null, no action is taken and no exception is thrown. De lo contrario, ToString se llama al método del objeto para generar la representación de cadena y, a continuación, la cadena resultante se escribe en el flujo de salida.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. La FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte signed integer to the text stream.

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.The 8-byte signed integer to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al Int64.ToString método.The text representation of the specified value is produced by calling the Int64.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Cómo: Escribir texto en un archivoHow to: Write Text to a File

Consulte también

Se aplica a

Write(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.Writes the text representation of a 4-byte signed integer to the text stream.

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.The 4-byte signed integer to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al Int32.ToString método.The text representation of the specified value is produced by calling the Int32.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Double)

Escribe la representación de texto de un punto flotante de 8 bytes en la secuencia de texto.Writes the text representation of an 8-byte floating-point value to the text stream.

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.The 8-byte floating-point value to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al Double.ToString método.The text representation of the specified value is produced by calling the Double.ToString method. La TextWriter.FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Decimal)

Escribe la representación de texto de un valor decimal en la secuencia de texto.Writes the text representation of a decimal value to the text stream.

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.The decimal value to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La FormatProvider propiedad, si no null , especifica el formato específico de la referencia cultural.The FormatProvider property, if not null, specifies the culture-specific formatting.

Consulte también

Se aplica a

Write(Char[])

Escribe una matriz de caracteres en la secuencia de texto.Writes a character array to the text stream.

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.The character array to write to the text stream.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

Este método no busca en la cadena especificada caracteres de nueva línea (hexadecimal 0x000a) y los reemplaza por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Este método predeterminado llama al Write(Char[], Int32, Int32) método y pasa toda la matriz de caracteres.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Si la matriz de caracteres es null , no se escribe nada.If the character array is null, nothing is written.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Char)

Escribe un carácter en la secuencia de texto.Writes a character to the text stream.

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.The character to write to the text stream.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

Este método predeterminado no hace nada, pero las clases derivadas pueden invalidar el método para proporcionar la funcionalidad adecuada.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(Boolean)

Escribe la representación de texto de un valor Boolean en la secuencia de texto.Writes the text representation of a Boolean value to the text stream.

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 Boolean que se va a escribir.The Boolean value to write.

Excepciones

La clase TextWriter está cerrada.The TextWriter is closed.

Error de E/S.An I/O error occurs.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada al Boolean.ToString método.The text representation of the specified value is produced by calling the Boolean.ToString method.

Este método genera Boolean.TrueString o Boolean.FalseString .This method outputs either Boolean.TrueString or Boolean.FalseString.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Consulte también

Se aplica a

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia de texto.Writes a character span to the text stream.

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.The character span to write.

Comentarios

La representación de texto del valor especificado se genera mediante una llamada a ReadOnlySpan . Método ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a