TextWriter.WriteLine Método

Definición

Escribe datos en la secuencia de texto seguidos de un terminador de línea.Writes data to the text stream, followed by a line terminator.

Sobrecargas

WriteLine(String, Object, Object)

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

WriteLine(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(String, Object[])

Escribe una cadena con formato y una línea nueva en la secuencia de texto con la misma semántica que Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object)

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

WriteLine(UInt64)

Escribe la representación de texto de un entero sin signo de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt32)

Escribe la representación de texto de un entero sin signo de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(String, Object, Object, Object)

Escribe una cadena con formato y una línea nueva en la secuencia de texto con la misma semántica que Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder)

Escribe la representación de texto de un generador de cadenas seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(String)

Escribe una cadena seguida de un terminador de línea en la secuencia de texto.Writes a string to the text stream, followed by a line terminator.

WriteLine(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Object)

Escribe la representación de texto de un objeto mediante una llamada al método ToString en ese objeto, seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Decimal)

Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto.Writes a character to the text stream, followed by a line terminator.

WriteLine(Boolean)

Escribe la representación de texto de un valor Boolean seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine()

Escribe un terminador de línea en la secuencia de texto.Writes a line terminator to the text stream.

WriteLine(ReadOnlySpan<Char>)

Escribe la representación de texto de un intervalo de caracteres seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(String, Object, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

Parámetros

format
String

Una 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 parámetro format consta 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
indexindex 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 , se produce una FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,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 ToString(string format) del objeto.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 interfaz IFormattable, null se pasa como el valor del parámetro format que se utiliza como la cadena de formato de IFormattable.ToString.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 solo 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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Char[], Int32, Int32)

Escribe una submatriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes a subarray of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

Parámetros

buffer
Char[]

Matriz de caracteres de la que se leen los datos.The character array from which data is read.

index
Int32

Posición del carácter en buffer donde comenzar a leer datos.The character position in buffer at which to start reading data.

count
Int32

Número máximo de caracteres que se van a escribir.The maximum 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 caracteres de datos en esta TextWriter de la matriz de caracteres buffer a partir de la 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 llamar al método Write(Char[]) seguido de WriteLine por cada carácter de buffer entre index y (index + count).This overload is equivalent to calling the Write(Char[]) method followed by WriteLine for each character in buffer between index and (index + count).

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(String, Object[])

Escribe una cadena con formato y una línea nueva en la secuencia de texto con la misma semántica que Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())

Parámetros

format
String

Una 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

Una cadena o un objeto se han pasado como null.A string or object is passed in as 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 parámetro format consta 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
indexindex 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 , se produce una FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,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 ToString(string format) del objeto.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 interfaz IFormattable, null se pasa como el valor del parámetro format que se utiliza como la cadena de formato de IFormattable.ToString.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 solo 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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(String, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object)

Parámetros

format
String

Una 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 parámetro format consta 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
indexindex 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 , se produce una FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,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 ToString(string format) del objeto.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 interfaz IFormattable, null se pasa como el valor del parámetro format que se utiliza como la cadena de formato de IFormattable.ToString.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 solo 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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(UInt64)

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero sin signo de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (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 método UInt64.ToString.The text representation of the specified value is produced by calling the UInt64.ToString method. La propiedad FormatProvider, si no null, especifica el formato específico de la referencia cultural.The FormatProvider property, if not null, specifies the culture-specific formatting.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(UInt32)

Importante

Esta API no es conforme a CLS.

Escribe la representación de texto de un entero sin signo de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (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 método UInt32.ToString.The text representation of the specified value is produced by calling the UInt32.ToString method. La propiedad FormatProvider, si no null, especifica el formato específico de la referencia cultural.The FormatProvider property, if not null, specifies the culture-specific formatting.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(String, Object, Object, Object)

Escribe una cadena con formato y una línea nueva en la secuencia de texto con la misma semántica que Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parámetros

format
String

Una 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 parámetro format consta 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
indexindex 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 , se produce una FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,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 ToString(string format) del objeto.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 interfaz IFormattable, null se pasa como el valor del parámetro format que se utiliza como la cadena de formato de IFormattable.ToString.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 solo 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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(StringBuilder)

Escribe la representación de texto de un generador de cadenas seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a string builder to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (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

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

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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.

WriteLine(String)

Escribe una cadena seguida de un terminador de línea en la secuencia de texto.Writes a string to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)

Parámetros

value
String

Cadena que se va a escribir.The string to write. Si value es null, sólo se escribe el terminador de línea.If value is null, only the line terminator is written.

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 sobrecarga de Write(Char[]).This overload is equivalent to the Write(Char[]) overload.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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.

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:

WriteLine(Single)

Escribe la representación de texto de un valor de punto flotante de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (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 propiedad FormatProvider, 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Consulte también:

WriteLine(Double)

Escribe la representación de texto de un valor de punto flotante de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (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 propiedad FormatProvider, 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Consulte también:

WriteLine(Object)

Escribe la representación de texto de un objeto mediante una llamada al método ToString en ese objeto, seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)

Parámetros

value
Object

Objeto que se escribirá.The object to write. Si value es null, sólo se escribe el terminador de línea.If value is null, only the line terminator is written.

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 sobrecarga de Write(String, Object).This overload is equivalent to the Write(String, Object) overload. La propiedad FormatProvider, si no null, especifica el formato específico de la referencia cultural.The FormatProvider property, if not null, specifies the culture-specific formatting.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Int64)

Escribe la representación de texto de un entero con signo de 8 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (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 método Int64.ToString.The text representation of the specified value is produced by calling the Int64.ToString method. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Int32)

Escribe la representación de texto de un entero con signo de 4 bytes seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (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 método Int32.ToString.The text representation of the specified value is produced by calling the Int32.ToString method. La propiedad TextWriter.FormatProvider, si no null, especifica el formato específico de la referencia cultural.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Decimal)

Escribe la representación de texto de un valor decimal seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (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 propiedad FormatProvider, 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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Consulte también:

WriteLine(Char[])

Escribe una matriz de caracteres seguida de un terminador de línea en la secuencia de texto.Writes an array of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())

Parámetros

buffer
Char[]

Matriz de caracteres de la que se leen los datos.The character array from which data is read.

Excepciones

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

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

Comentarios

Todos los caracteres de buffer se escriben en la secuencia subyacente.All the characters in buffer are written to the underlying stream. Si la matriz de caracteres es null, sólo se escribe el terminador de línea.If the character array is null, only the line terminator is written.

Esta sobrecarga es equivalente a Write(Char[]) seguido de WriteLine().This overload is equivalent to Write(Char[]) followed by WriteLine() .

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Char)

Escribe un carácter seguido de un terminador de línea en la secuencia de texto.Writes a character to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (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

Esta sobrecarga es equivalente a Write(Char) seguido de WriteLine().This overload is equivalent to Write(Char) followed by WriteLine() .

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(Boolean)

Escribe la representación de texto de un valor Boolean seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (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 método Boolean.ToString.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.

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine()

Escribe un terminador de línea en la secuencia de texto.Writes a line terminator to the text stream.

public:
 virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()

Excepciones

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

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

Comentarios

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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:

WriteLine(ReadOnlySpan<Char>)

Escribe la representación de texto de un intervalo de caracteres seguida de un terminador de línea en la secuencia de texto.Writes the text representation of a character span to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

Parámetros

buffer
ReadOnlySpan<Char>

Intervalo de caracteres que se va a escribir en la secuencia de texto.The char span value to write to the text stream.

Comentarios

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

El terminador de línea se define mediante el campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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