TextWriter.Write 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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Grava dados em um fluxo de texto.

Sobrecargas

Write(String, Object, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Grava uma subarray de caracteres no fluxo de texto.
Write(String, ReadOnlySpan<Object>)	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object[]).
Write(String, Object)	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object).
Write(UInt64)	Grava a representação de texto de um inteiro sem sinal de 8 bytes no fluxo de texto.
Write(UInt32)	Grava a representação de texto de um inteiro sem sinal de 4 bytes no fluxo de texto.
Write(StringBuilder)	Grava um construtor de cadeias de caracteres no fluxo de texto.
Write(String)	Grava uma cadeia de caracteres no fluxo de texto.
Write(Single)	Grava a representação de texto de um valor de ponto flutuante de 4 bytes no fluxo de texto.
Write(String, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object, Object).
Write(Object)	Grava a representação de texto de um objeto no fluxo de texto chamando o método `ToString` nesse objeto.
Write(Int64)	Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto.
Write(Int32)	Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto.
Write(Double)	Grava a representação de texto de um valor de ponto flutuante de 8 bytes no fluxo de texto.
Write(Decimal)	Grava a representação de texto de um valor decimal no fluxo de texto.
Write(Char[])	Grava uma matriz de caracteres no fluxo de texto.
Write(Char)	Grava um caractere no fluxo de texto.
Write(Boolean)	Grava a representação de texto de um valor `Boolean` no fluxo de texto.
Write(ReadOnlySpan<Char>)	Grava um intervalo de caracteres no fluxo de texto.

Write(String, Object, Object, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object, Object, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void Write (string format, object arg0, object arg1, object arg2);

public virtual void Write (string format, object? arg0, object? arg1, object? arg2);

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parâmetros

format: String

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:

Para obter mais informações sobre o recurso de formatação composta, consulte Formatação Composta.
Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre especificadores de formato de data e hora, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas.
Para obter mais informações sobre especificadores de formato de enumeração, consulte cadeias de caracteres de formato de enumeração.
Para obter mais informações sobre formatação, consulte Tipos 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 TextWriter.NewLine.

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

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char[], Int32, Int32)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma subarray de caracteres no fluxo de texto.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Parâmetros

buffer: Char[]

A matriz de caracteres da qual gravar dados.

index: Int32

A posição do caractere no buffer no qual começar a recuperar dados.

count: Int32

O número 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 à sobrecarga de Write(Char[]) para cada caractere em buffer entre index e (index + count).

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, ReadOnlySpan<Object>)

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

public:
 virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);

abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit

Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))

Parâmetros

format: String

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

.NET 9

Produto	Versões
.NET	9

Write(String, Object[])

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object[]).

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params object[] arg);

public virtual void Write (string format, params object?[] arg);

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

Parâmetros

format: String

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

format ou arg é 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

Para obter mais informações sobre o recurso de formatação composta, consulte Formatação Composta.
Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre especificadores de formato de data e hora, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas.
Para obter mais informações sobre especificadores de formato de enumeração, consulte cadeias de caracteres de formato de enumeração.
Para obter mais informações sobre formatação, consulte Tipos de Formatação.

A sintaxe de um item de formato é a seguinte:

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

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.

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

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

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Parâmetros

format: String

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

Para obter mais informações sobre o recurso de formatação composta, consulte Formatação Composta.
Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre especificadores de formato de data e hora, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas.
Para obter mais informações sobre especificadores de formato de enumeração, consulte cadeias de caracteres de formato de enumeração.
Para obter mais informações sobre formatação, consulte Tipos de Formatação.

A sintaxe de um item de formato é a seguinte:

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

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.

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

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

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Parâmetros

value: UInt64

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Parâmetros

value: UInt32

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(StringBuilder)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava um construtor de cadeias de caracteres no fluxo de texto.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Parâmetros

value: StringBuilder

A cadeia de caracteres, como um construtor de cadeias de caracteres, a ser gravada no fluxo de texto.

Comentários

Esse método é equivalente a Write(stringBuilder.ToString()), mas usa o método StringBuilder.GetChunks para evitar a criação da cadeia de caracteres intermediária.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(String)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma cadeia de caracteres no fluxo de texto.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Parâmetros

value: String

A cadeia de caracteres a ser gravada.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

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

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

Se value for null, nada será gravado no fluxo de texto.

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Parâmetros

value: Single

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 representação de texto do valor especificado é produzida chamando o método Single.ToString. A propriedade TextWriter.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.

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String, Object, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica que o método Format(String, Object, Object).

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object arg0, object arg1);

public virtual void Write (string format, object? arg0, object? arg1);

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

Parâmetros

format: String

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

Para obter mais informações sobre o recurso de formatação composta, consulte Formatação Composta.
Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre especificadores de formato de data e hora, consulte cadeias de caracteres de formato de data e hora padrão e cadeias de caracteres de formato de data e hora personalizadas.
Para obter mais informações sobre especificadores de formato de enumeração, consulte cadeias de caracteres de formato de enumeração.
Para obter mais informações sobre formatação, consulte Tipos de Formatação.

A sintaxe de um item de formato é a seguinte:

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

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.

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

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

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Parâmetros

value: Object

O objeto a 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).

Se o objeto especificado for null, nenhuma ação será tomada e nenhuma exceção será gerada. Caso contrário, o método ToString do objeto é chamado para produzir a representação de cadeia de caracteres e, em seguida, a cadeia de caracteres resultante é gravada no fluxo de saída. 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.

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Parâmetros

value: Int64

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.

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

Como gravar texto em um arquivo

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Parâmetros

value: Int32

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.

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(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.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Parâmetros

value: Double

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 representação de texto do valor especificado é produzida chamando o método Double.ToString. A propriedade TextWriter.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.

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Decimal)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava a representação de texto de um valor decimal no fluxo de texto.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Parâmetros

value: Decimal

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.

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char[])

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava uma matriz de caracteres no fluxo de texto.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[] buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Parâmetros

buffer: Char[]

A matriz de caracteres a ser gravada no fluxo de texto.

Exceções

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

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

Esse método padrão chama o método Write(Char[], Int32, Int32) e passa toda a matriz de caracteres. Se a matriz de caracteres for null, nada será escrito.

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Char)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava um caractere no fluxo de texto.

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

abstract member Write : char -> unit
override this.Write : char -> unit

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

Parâmetros

value: Char

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

Esse método padrão não faz nada, mas classes derivadas podem substituir o método para fornecer a funcionalidade apropriada.

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(Boolean)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava a representação de texto de um valor Boolean no fluxo de texto.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Parâmetros

value: Boolean

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.

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

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(ReadOnlySpan<Char>)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava um intervalo de caracteres no fluxo de texto.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Parâmetros

buffer: ReadOnlySpan<Char>

O intervalo de caracteres a ser gravado.

Comentários

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

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

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Festival de Habilidades de IA

Compartilhar via

TextWriter.Write Método

Definição

Sobrecargas

Write(String, Object, Object, Object)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(Char[], Int32, Int32)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(String, ReadOnlySpan<Object>)

Parâmetros

Aplica-se a

Write(String, Object[])

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(String, Object)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(UInt64)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(UInt32)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(StringBuilder)

Parâmetros

Comentários

Aplica-se a

Write(String)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(Single)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(String, Object, Object)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(Object)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(Int64)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Write(Int32)

Parâmetros