Compartilhar via

TextWriter.WriteLine Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Grava dados no fluxo de texto, seguido por um terminador de linha.

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).
WriteLine(Char[], Int32, Int32)

Grava uma subarray de caracteres no fluxo de texto, seguida por um terminador de linha.
WriteLine(String, ReadOnlySpan<Object>)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que Format(String, ReadOnlySpan<Object>).
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).
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).
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.
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).
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.
WriteLine(StringBuilder)

Grava a representação de texto de um construtor de cadeias de caracteres no fluxo de texto, seguido por um terminador de linha.
WriteLine(String)

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

Grava a representação de texto de um valor decimal no fluxo de texto, seguido por um terminador de linha.
WriteLine(Char[])

Grava uma matriz de caracteres no fluxo de texto, seguido por um terminador de linha.
WriteLine(Char)

Grava um caractere no fluxo de texto, seguido por um terminador de linha.
WriteLine(Boolean)

Grava a representação de texto de um valor Boolean no fluxo de texto, seguido por um terminador de linha.
WriteLine()

Grava um terminador de linha no fluxo de texto.
WriteLine(ReadOnlySpan<Char>)

Grava a representação de texto de um intervalo de caracteres no fluxo de texto, seguido por um terminador de linha.

WriteLine(String, Object, Object)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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

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

arg0
Object

O primeiro objeto a ser formatado e gravado.

arg1
Object

O segundo objeto a ser formatado e gravado.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

FormatException

format não é uma cadeia de caracteres de formato composto válida.

-ou-

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

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. O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

{de índice [,comprimento][:formatString]}

Elementos em colchetes são opcionais. A tabela a seguir descreve cada elemento. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte Formatação Composta.

Elemento Descrição
índice A posição baseada em zero na lista de parâmetros do objeto a ser formatado. Se o objeto especificado por índice for null, o item de formato será substituído por String.Empty. Como essa sobrecarga tem dois objetos em sua lista de parâmetros, o valor de índice deve ser sempre 0 ou 1. Se não houver nenhum parâmetro na posição de índice , um será gerado.
,comprimento O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se positivo, o parâmetro está alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString Uma cadeia de caracteres de formato padrão ou personalizado compatível com o objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores compatíveis com o método ToString(string format) do objeto. Se formatString não for especificado e o objeto a ser formatado implementar a interface IFormattable, null será passado como o valor do parâmetro format usado como a cadeia de caracteres de formato IFormattable.ToString.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários. Para especificar um único caractere de chave literal em format, especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Char[], Int32, Int32)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava uma subarray de caracteres no fluxo de texto, seguida por um terminador de linha.

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.

index
Int32

A posição do caractere em buffer na qual iniciar a leitura de dados.

count
Int32

O número máximo de caracteres a serem gravados.

Exceções

ArgumentException

O comprimento do buffer menos index é menor que count.

ArgumentNullException

O parâmetro buffer é null.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Esse método gravará count caracteres de dados neste TextWriter da matriz de caracteres buffer começando na posição index.

Essa sobrecarga é equivalente a chamar o método Write(Char[]) seguido por WriteLine para cada caractere em buffer entre index e (index + count).

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(String, ReadOnlySpan<Object>)

Grava uma cadeia de caracteres formatada e uma nova linha no fluxo de texto, usando a mesma semântica que Format(String, ReadOnlySpan<Object>).

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

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg
ReadOnlySpan<Object>

Um intervalo de objeto que contém zero ou mais objetos para formatar e gravar.

Aplica-se a

WriteLine(String, Object[])

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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

arg
Object[]

Uma matriz de objetos que contém zero ou mais objetos para formatar e gravar.

Exceções

ArgumentNullException

Uma cadeia de caracteres ou objeto é passado como null.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

FormatException

format não é uma cadeia de caracteres de formato composto válida.

-ou-

O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao comprimento da matriz arg.

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. O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

{de índice [,comprimento][:formatString]}

Elementos em colchetes são opcionais. A tabela a seguir descreve cada elemento. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte Formatação Composta.

Elemento Descrição
índice A posição baseada em zero na lista de parâmetros do objeto a ser formatado. Se o objeto especificado por índice for null, o item de formato será substituído por String.Empty. Como essa sobrecarga tem uma matriz em sua lista de parâmetros, o valor de índice deve ser sempre menor que o comprimento da matriz. Se não houver nenhum parâmetro na posição de índice , um será gerado.
,comprimento O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se positivo, o parâmetro está alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString Uma cadeia de caracteres de formato padrão ou personalizado compatível com o objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores compatíveis com o método ToString(string format) do objeto. Se formatString não for especificado e o objeto a ser formatado implementar a interface IFormattable, null será passado como o valor do parâmetro format usado como a cadeia de caracteres de formato IFormattable.ToString.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários. Para especificar um único caractere de chave literal em format, especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(String, Object)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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

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

arg0
Object

O objeto a ser formatado e gravado.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

FormatException

format não é uma cadeia de caracteres de formato composto válida.

-ou-

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

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. O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

{de índice [,comprimento][:formatString]}

Elementos em colchetes são opcionais. A tabela a seguir descreve cada elemento. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte Formatação Composta.

Elemento Descrição
índice A posição baseada em zero na lista de parâmetros do objeto a ser formatado. Se o objeto especificado por índice for null, o item de formato será substituído por String.Empty. Como essa sobrecarga tem apenas um único objeto em sua lista de parâmetros, o valor de índice deve ser sempre 0. Se não houver nenhum parâmetro na posição de índice , um será gerado.
,comprimento O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se positivo, o parâmetro está alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString Uma cadeia de caracteres de formato padrão ou personalizado compatível com o objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores compatíveis com o método ToString(string format) do objeto. Se formatString não for especificado e o objeto a ser formatado implementar a interface IFormattable, null será passado como o valor do parâmetro format usado como a cadeia de caracteres de formato IFormattable.ToString.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários. Para especificar um único caractere de chave literal em format, especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(UInt64)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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.

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.

Atributos
CLSCompliantAttribute

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A representação de texto do valor especificado é produzida chamando o método UInt64.ToString. A propriedade FormatProvider, se não null, especifica a formatação específica da cultura.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(String, Object, Object, Object)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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

arg0
Object

O primeiro objeto a ser formatado e gravado.

arg1
Object

O segundo objeto a ser formatado e gravado.

arg2
Object

O terceiro objeto a ser formatado e gravado.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

FormatException

format não é uma cadeia de caracteres de formato composto válida.

-ou-

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

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. O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

O parâmetro format consiste em zero ou mais execuções de texto intermixado com zero ou mais espaços reservados indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros desse método. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

{de índice [,comprimento][:formatString]}

Elementos em colchetes são opcionais. A tabela a seguir descreve cada elemento. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte Formatação Composta.

Elemento Descrição
índice A posição baseada em zero na lista de parâmetros do objeto a ser formatado. Se o objeto especificado por índice for null, o item de formato será substituído por String.Empty. Como essa sobrecarga tem três objetos em sua lista de parâmetros, o valor de índice deve ser sempre 0, 1 ou 2. Se não houver nenhum parâmetro na posição de índice , um será gerado.
,comprimento O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se positivo, o parâmetro está alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString Uma cadeia de caracteres de formato padrão ou personalizado compatível com o objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores compatíveis com o método ToString(string format) do objeto. Se formatString não for especificado e o objeto a ser formatado implementar a interface IFormattable, null será passado como o valor do parâmetro format usado como a cadeia de caracteres de formato IFormattable.ToString.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários. Para especificar um único caractere de chave literal em format, especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(UInt32)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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.

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.

Atributos
CLSCompliantAttribute

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A representação de texto do valor especificado é produzida chamando o método UInt32.ToString. A propriedade FormatProvider, se não null, especifica a formatação específica da cultura.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(StringBuilder)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um construtor de cadeias de caracteres no fluxo de texto, seguido por um terminador de linha.

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 cadeias de caracteres, a ser gravada no fluxo de texto.

Comentários

A representação de texto do valor especificado é produzida chamando o método StringBuilder.ToString.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Aplica-se a

WriteLine(String)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.

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. Se value for null, somente o terminador de linha será gravado.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Essa sobrecarga é equivalente à sobrecarga de Write(Char[]).

O terminador de linha é definido pelo campo CoreNewLine.

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Single)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A propriedade FormatProvider, se não null, especifica a formatação específica da cultura. Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

O terminador de linha é definido pelo campo CoreNewLine.

Confira também

Aplica-se a

WriteLine(Double)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A propriedade FormatProvider, se não null, especifica a formatação específica da cultura. Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

O terminador de linha é definido pelo campo CoreNewLine.

Confira também

Aplica-se a

WriteLine(Object)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

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.

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. Se value for null, somente o terminador de linha será gravado.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Essa sobrecarga é equivalente à sobrecarga de Write(String, Object). A propriedade FormatProvider, se não null, especifica a formatação específica da cultura.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Int64)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A representação de texto do valor especificado é produzida chamando o método Int64.ToString. A propriedade TextWriter.FormatProvider, se não null, especifica a formatação específica da cultura.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Int32)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A representação de texto do valor especificado é produzida chamando o método Int32.ToString. A propriedade TextWriter.FormatProvider, se não null, especifica a formatação específica da cultura.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Decimal)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um valor decimal no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A propriedade FormatProvider, se não null, especifica a formatação específica da cultura. Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

O terminador de linha é definido pelo campo CoreNewLine.

Confira também

Aplica-se a

WriteLine(Char[])

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava uma matriz de caracteres no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Todos os caracteres em buffer são gravados no fluxo subjacente. Se a matriz de caracteres for null, somente o terminador de linha será gravado.

Essa sobrecarga é equivalente a Write(Char[]) seguida por WriteLine() .

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Char)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava um caractere no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Essa sobrecarga é equivalente a Write(Char) seguida por WriteLine() .

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(Boolean)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um valor Boolean no fluxo de texto, seguido por um terminador de linha.

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.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A representação de texto do valor especificado é produzida chamando o método Boolean.ToString.

Esse método gera Boolean.TrueString ou Boolean.FalseString.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine()

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava um terminador de linha no fluxo de texto.

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

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

Aplica-se a

WriteLine(ReadOnlySpan<Char>)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
Origem:
TextWriter.cs

Grava a representação de texto de um intervalo de caracteres no fluxo de texto, seguido por um terminador de linha.

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 de intervalo de caracteres a ser gravado no fluxo de texto.

Comentários

A representação de texto do valor especificado é produzida chamando o><Char ReadOnlySpan. Método ToString.

O terminador de linha é definido pelo campo CoreNewLine.

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Aplica-se a