Compartilhar via


TextWriter.Write Método

Definição

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

format é null.

Ocorre um erro de E/S.

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

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

O comprimento do buffer menos index é menor que count.

O parâmetro buffer é null.

index ou count é negativo.

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

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

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

format ou arg é null.

Ocorre um erro de E/S.

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

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

format é null.

Ocorre um erro de E/S.

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

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

Exceções

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

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

Exceções

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

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

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

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

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

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

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

format é null.

Ocorre um erro de E/S.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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