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 do método Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Grava uma submatriz de caracteres no fluxo de texto.
Write(String, Object[])	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do método Format(String, Object[]).
Write(String, Object)	Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do 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 cadeia 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 do 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 do 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 de composição.

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 de composição 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 suporte extensivo à 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 combinadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros desse método. 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:

{index[,length][:formatString]}

Os elementos entre 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 pelo í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 do índice sempre deve ser 0, 1 ou 2. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.
,length	O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se for positivo, o parâmetro será alinhado à direita; se for negativo, ele será 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 do `ToString(string format)` objeto. Se formatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, `null` será passado como o valor do `format` parâmetro usado como a IFormattable.ToString cadeia de caracteres de formato.

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 hexadecimais) 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 submatriz 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 os dados serão gravados.

index: Int32

A posição do caractere no buffer em que iniciar a recuperação de dados.

count: Int32

O número de caracteres a serem gravados.

Exceções

ArgumentException

O tamanho 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 na TextWriter matriz de buffer caracteres começando na posição index.

Essa sobrecarga é equivalente à Write(Char[]) sobrecarga de cada caractere entre indexbuffer 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, 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 do 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 de composição.

arg: Object[]

Uma matriz de objetos que contém zero ou mais objetos a serem formatados e gravados.

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 de composição válida.

- ou -

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

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:

{index[,length][: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 pelo í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 do índice sempre deve ser menor que o comprimento da matriz. Se não houver nenhum parâmetro na posição de índice , um FormatException será gerado.
,length	O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro . Se positivo, o parâmetro é alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString	Uma cadeia de caracteres de formato padrão ou personalizada 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 do `ToString(string format)` objeto. Se formatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, `null` será passado como o valor do `format` parâmetro usado como a IFormattable.ToString cadeia de caracteres de formato.

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 do 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 de composição.

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 de composição 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:

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:

{index[,length][: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 pelo í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 do índice sempre deve ser 0. Se não houver nenhum parâmetro na posição de índice , um FormatException será gerado.
,length	O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro . Se positivo, o parâmetro é alinhado à direita; se negativo, ele é alinhado à esquerda.
:formatString	Uma cadeia de caracteres de formato padrão ou personalizada 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 do `ToString(string format)` objeto. Se formatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, `null` será passado como o valor do `format` parâmetro usado como a IFormattable.ToString cadeia de caracteres de formato.

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: 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 UInt64.ToString método . A TextWriter.FormatProvider propriedade , 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: 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 UInt32.ToString método . A TextWriter.FormatProvider propriedade , 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 cadeia 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 cadeia de caracteres, a ser gravada no fluxo de texto.

Comentários

Esse método é equivalente a Write(stringBuilder.ToString()), mas usa o StringBuilder.GetChunks método 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

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

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

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimais) 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

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 Single.ToString método . A TextWriter.FormatProvider propriedade , 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 do 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 de composição.

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 de composição 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:

{index[,length][: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 pelo í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 do índice sempre deve ser 0 ou 1. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.
,length	O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Se for positivo, o parâmetro será alinhado à direita; se for negativo, ele será 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 do `ToString(string format)` objeto. Se formatString não for especificado e o objeto a ser formatado implementar a IFormattable interface, `null` será passado como o valor do `format` parâmetro usado como a IFormattable.ToString cadeia de caracteres de formato.

Esse método não pesquisa a cadeia de caracteres especificada para caracteres de nova linha individuais (0x000a hexadecimais) 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

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Essa sobrecarga é equivalente à Write(String) sobrecarga.

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

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 Int64.ToString método . A TextWriter.FormatProvider propriedade , 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

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 Int32.ToString método . A TextWriter.FormatProvider propriedade , 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

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 Double.ToString método . A TextWriter.FormatProvider propriedade , 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

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A FormatProvider propriedade , 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

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 Write(Char[], Int32, Int32) método e passa toda a matriz de caracteres. Se a matriz de caracteres for null, nada será gravado.

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

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

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 Boolean.ToString método .

Esse método gera ou Boolean.TrueString 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 Caractere ReadOnlySpan<>. Método ToString.

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

Aplica-se a