TextWriter.WriteLine Método

Definição

Grava dados no fluxo de texto, seguidos por um terminador de linha.Writes data to the text stream, followed by a line terminator.

Sobrecargas

WriteLine(String, Object, Object)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que o 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)

Grava uma submatriz de caracteres no fluxo de texto, seguida por um terminador de linha.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(String, Object[])

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma 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)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que o 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)

Grava a representação de texto de um inteiro sem sinal de 8 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt32)

Grava a representação de texto de um inteiro sem sinal de 4 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(String, Object, Object, Object)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma 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)

Grava a representação de texto de um construtor de cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(String)

Grava uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.Writes a string to the text stream, followed by a line terminator.

WriteLine(Single)

Grava a representação de texto de um valor de ponto flutuante de 4 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Double)

Grava a representação de texto de um valor de ponto flutuante de 8 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Object)

Grava a representação de texto de um objeto no fluxo de texto chamando o método ToString nesse objeto, seguido por um terminador de linha.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)

Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int32)

Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto, seguido por um terminador de linha.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Decimal)

Grava a representação de texto de um valor decimal no fluxo de texto, seguida por um terminador de linha.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Char[])

Grava uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char)

Grava um caractere no fluxo de texto, seguido por um terminador de linha.Writes a character to the text stream, followed by a line terminator.

WriteLine(Boolean)

Grava a representação de texto de um valor Boolean no fluxo de texto, seguida por um terminador de linha.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine()

Grava um terminador de linha no fluxo de texto.Writes a line terminator to the text stream.

WriteLine(ReadOnlySpan<Char>)

Grava a representação de texto de um intervalo de caracteres no fluxo de texto, seguido por um terminador de linha.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(String, Object, Object)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que o 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);
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

Uma cadeia de caracteres de formato de composição.A composite format string.

arg0
Object

O primeiro objeto a ser formatado e gravado.The first object to format and write.

arg1
Object

O segundo objeto a ser formatado e gravado.The second object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao número de objetos a serem formatados (que, para essa sobrecarga de método, é dois).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).

Comentários

Esse método usa a formatação composta para converter o valor de um objeto em sua representação de cadeia de caracteres e inserir essa representação em uma cadeia de caracteres.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

O parâmetro format consiste em zero ou mais execuções de texto combinadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros desse 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. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

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

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem dois objetos em sua lista de parâmetros, o valor do índice deve ser sempre 0 ou 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, null será passado como o valor do format parâmetro usado como a IFormattable.ToString cadeia de caracteres 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.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Char[], Int32, Int32)

Grava uma submatriz de caracteres no fluxo de texto, seguida por um terminador de linha.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[]

A matriz de caracteres da qual os dados são lidos.The character array from which data is read.

index
Int32

A posição do caractere no buffer no qual a leitura de dados é iniciada.The character position in buffer at which to start reading data.

count
Int32

O número máximo de caracteres a serem gravados.The maximum number of characters to write.

Exceções

O tamanho do buffer menos index é menor que count.The buffer length minus index is less than count.

O parâmetro buffer é null.The buffer parameter is null.

index ou count é negativo.index or count is negative.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Esse método gravará count caracteres de dados nele TextWriter a partir da buffer matriz de caracteres começando na posição index .This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Essa sobrecarga é equivalente a chamar o Write(Char[]) método seguido por WriteLine para cada caractere buffer entre index e ( 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).

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(String, Object[])

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma 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);
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

Uma cadeia de caracteres de formato de composição.A composite format string.

arg
Object[]

Uma matriz de objetos que contém zero ou mais objetos a serem formatados e gravados.An object array that contains zero or more objects to format and write.

Exceções

Uma cadeia de caracteres ou objeto é passado como null.A string or object is passed in as null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao tamanho da 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.

Comentários

Esse método usa a formatação composta para converter o valor de um objeto em sua representação de cadeia de caracteres e inserir essa representação em uma cadeia de caracteres.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

O parâmetro format consiste em zero ou mais execuções de texto combinadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros desse 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. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

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

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem uma matriz em sua lista de parâmetros, o valor do índice deve ser sempre menor que o comprimento da 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. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, null será passado como o valor do format parâmetro usado como a IFormattable.ToString cadeia de caracteres 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.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(String, Object)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que o 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);
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

Uma cadeia de caracteres de formato de composição.A composite format string.

arg0
Object

O objeto a ser formatado e gravado.The object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao número de objetos a serem formatados (que, para essa sobrecarga de método, é um).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).

Comentários

Esse método usa a formatação composta para converter o valor de um objeto em sua representação de cadeia de caracteres e inserir essa representação em uma cadeia de caracteres.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

O parâmetro format consiste em zero ou mais execuções de texto combinadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros desse 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. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

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

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem apenas um único objeto em sua lista de parâmetros, o valor de index deve ser sempre 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, null será passado como o valor do format parâmetro usado como a IFormattable.ToString cadeia de caracteres 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.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(UInt64)

Importante

Esta API não está em conformidade com CLS.

Grava a representação de texto de um inteiro sem sinal de 8 bytes no fluxo de texto, seguido por um terminador de linha.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);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (value As ULong)

Parâmetros

value
UInt64

O inteiro sem sinal de 8 bytes a ser gravado.The 8-byte unsigned integer to write.

Atributos

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o UInt64.ToString método.The text representation of the specified value is produced by calling the UInt64.ToString method. A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(UInt32)

Importante

Esta API não está em conformidade com CLS.

Grava a representação de texto de um inteiro sem sinal de 4 bytes no fluxo de texto, seguido por um terminador de linha.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);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (value As UInteger)

Parâmetros

value
UInt32

O inteiro sem sinal de 4 bytes a ser gravado.The 4-byte unsigned integer to write.

Atributos

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o UInt32.ToString método.The text representation of the specified value is produced by calling the UInt32.ToString method. A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(String, Object, Object, Object)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma 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);
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

Uma cadeia de caracteres de formato de composição.A composite format string.

arg0
Object

O primeiro objeto a ser formatado e gravado.The first object to format and write.

arg1
Object

O segundo objeto a ser formatado e gravado.The second object to format and write.

arg2
Object

O terceiro objeto a ser formatado e gravado.The third object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao número de objetos a serem formatados (que, para essa sobrecarga de método, é três).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).

Comentários

Esse método usa a formatação composta para converter o valor de um objeto em sua representação de cadeia de caracteres e inserir essa representação em uma cadeia de caracteres.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

O parâmetro format consiste em zero ou mais execuções de texto combinadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros desse 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. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

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

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem três objetos em sua lista de parâmetros, o valor do índice sempre deve ser 0, 1 ou 2.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, null será passado como o valor do format parâmetro usado como a IFormattable.ToString cadeia de caracteres 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.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(StringBuilder)

Grava a representação de texto de um construtor de cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.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

A cadeia de caracteres, como um construtor de cadeia de caracteres, a ser gravada no fluxo de texto.The string, as a string builder, to write to the text stream.

Comentários

A representação de texto do valor especificado é produzida chamando o StringBuilder.ToString método.The text representation of the specified value is produced by calling the StringBuilder.ToString method.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Aplica-se a

WriteLine(String)

Grava uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.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);
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

A cadeia de caracteres a ser gravada.The string to write. Se value for null, o terminador de linha será gravado.If value is null, only the line terminator is written.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Essa sobrecarga é equivalente à Write(Char[]) sobrecarga.This overload is equivalent to the Write(Char[]) overload.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Single)

Grava a representação de texto de um valor de ponto flutuante de 4 bytes no fluxo de texto, seguido por um terminador de linha.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

O valor de ponto flutuante de 4 bytes a ser gravado.The 4-byte floating-point value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting. Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a

WriteLine(Double)

Grava a representação de texto de um valor de ponto flutuante de 8 bytes no fluxo de texto, seguido por um terminador de linha.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

O valor de ponto flutuante de 8 bytes a ser gravado.The 8-byte floating-point value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting. Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a

WriteLine(Object)

Grava a representação de texto de um objeto no fluxo de texto chamando o método ToString nesse objeto, seguido por um terminador de linha.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);
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

O objeto a ser gravado.The object to write. Se value for null, o terminador de linha será gravado.If value is null, only the line terminator is written.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Essa sobrecarga é equivalente à Write(String, Object) sobrecarga.This overload is equivalent to the Write(String, Object) overload. A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Int64)

Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto, seguido por um terminador de linha.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

O inteiro com sinal de 8 bytes a ser gravado.The 8-byte signed integer to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Int64.ToString método.The text representation of the specified value is produced by calling the Int64.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Int32)

Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto, seguido por um terminador de linha.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

O inteiro com sinal de 4 bytes a ser gravado.The 4-byte signed integer to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Int32.ToString método.The text representation of the specified value is produced by calling the Int32.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Decimal)

Grava a representação de texto de um valor decimal no fluxo de texto, seguida por um terminador de linha.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

O valor decimal a ser gravado.The decimal value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting. Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a

WriteLine(Char[])

Grava uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.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);
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[]

A matriz de caracteres da qual os dados são lidos.The character array from which data is read.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Todos os caracteres em buffer são gravados no fluxo subjacente.All the characters in buffer are written to the underlying stream. Se a matriz de caracteres for null, somente o terminador de linha será gravado.If the character array is null, only the line terminator is written.

Essa sobrecarga é equivalente à Write(Char[]) seguida por WriteLine() .This overload is equivalent to Write(Char[]) followed by WriteLine() .

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Char)

Grava um caractere no fluxo de texto, seguido por um terminador de linha.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

O caractere a ser gravado no fluxo de texto.The character to write to the text stream.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Essa sobrecarga é equivalente à Write(Char) seguida por WriteLine() .This overload is equivalent to Write(Char) followed by WriteLine() .

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(Boolean)

Grava a representação de texto de um valor Boolean no fluxo de texto, seguida por um terminador de linha.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

O valor Boolean a ser gravado.The Boolean value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Boolean.ToString método.The text representation of the specified value is produced by calling the Boolean.ToString method.

Esse método gera uma saída Boolean.TrueString de ou Boolean.FalseString .This method outputs either Boolean.TrueString or Boolean.FalseString.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine()

Grava um terminador de linha no fluxo 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 ()

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

WriteLine(ReadOnlySpan<Char>)

Grava a representação de texto de um intervalo de caracteres no fluxo de texto, seguido por um terminador de linha.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>

O valor do intervalo de caracteres a ser gravado no fluxo de texto.The char span value to write to the text stream.

Comentários

A representação de texto do valor especificado é produzida chamando o ReadOnlySpan . Método ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Aplica-se a