TextWriter.Write Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.IO.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve dados num fluxo de texto.

Sobrecargas

Name	Description
Write(String, Object, Object, Object)	Escreve uma cadeia formatada no fluxo de texto, usando a mesma semântica do Format(String, Object, Object, Object) método.
Write(String, Object, Object)	Escreve uma string formatada no fluxo de texto usando a mesma semântica do Format(String, Object, Object) método.
Write(Char[], Int32, Int32)	Escreve um subarray de caracteres no fluxo de texto.
Write(String, ReadOnlySpan<Object>)	Escreve uma string formatada no fluxo de texto, usando a mesma semântica que Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Escreve uma cadeia formatada no fluxo de texto, usando a mesma semântica do Format(String, Object[]) método.
Write(String, Object)	Escreve uma cadeia formatada no fluxo de texto, usando a mesma semântica do Format(String, Object) método.
Write(UInt64)	Escreve a representação textual de um inteiro sem sinal de 8 bytes no fluxo de texto.
Write(UInt32)	Escreve a representação textual de um inteiro sem sinal de 4 bytes no fluxo de texto.
Write(StringBuilder)	Escreve um construtor de cadeias no fluxo de texto.
Write(Rune)
Write(String)	Escreve uma cadeia no fluxo de texto.
Write(Decimal)	Escreve a representação textual de um valor decimal no fluxo de texto.
Write(ReadOnlySpan<Char>)	Escreve um espaço de caracteres no fluxo de texto.
Write(Object)	Escreve a representação textual de um objeto no fluxo de texto chamando o `ToString` método nesse objeto.
Write(Int64)	Escreve a representação textual de um inteiro com sinal de 8 bytes no fluxo de texto.
Write(Int32)	Escreve a representação textual de um inteiro com sinal de 4 bytes no fluxo de texto.
Write(Double)	Grava a representação textual de um valor de vírgula flutuante de 8 bytes no fluxo de texto.
Write(Char[])	Escreve um array de caracteres no fluxo de texto.
Write(Char)	Escreve um carácter no fluxo de texto.
Write(Boolean)	Escreve a representação textual de um `Boolean` valor no fluxo de texto.
Write(Single)	Grava a representação textual de um valor de vírgula flutuante de 4 bytes no fluxo de texto.

Write(String, Object, Object, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve uma cadeia formatada no fluxo de texto, usando a mesma semântica do Format(String, Object, Object, Object) método.

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

arg0: Object

O primeiro objeto a formatar e a escrever.

arg1: Object

O segundo objeto: formatar e escrever.

arg2: Object

O terceiro objetivo é formatar e escrever.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

FormatException

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

-ou-

O índice de um item de formato é inferior a 0 (zero), ou maior ou igual ao número de objetos a formatar (que, neste caso de sobrecarga de métodos, é três).

Observações

Este método utiliza formatação composta para converter o valor de um objeto na sua representação de cadeia e para incorporar essa representação numa cadeia. O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:

Para mais informações sobre a funcionalidade de formatação composta, consulte Formatação composta.
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre especificadores de formato de data e hora, consulte Cadeias de Formato de Data e Hora Padrão e Cadeias de Formato de Data e Hora Personalizadas.
Para mais informações sobre especificadores de formato de enumeração, consulte Strings de Formato de Enumeração.
Para mais informações sobre formatação, consulte Tipos de Formatação.

O format parâmetro consiste em zero ou mais sequências de texto misturadas com zero ou mais marcadores indexados, chamados itens de formato, que correspondem a um objeto na lista de parâmetros deste método. O processo de formatação substitui cada item de formato pela representação em cadeia do valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

{index[,length][:formatString]}

Os elementos entre parênteses retos são opcionais. A tabela a seguir descreve cada elemento. Para mais informações sobre a funcionalidade de formatação composta, incluindo a sintaxe de um elemento de formato, consulte Formatação Composta.

Elemento	Descrição
indexar	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 é substituído por String.Empty. Como esta sobrecarga tem três objetos na sua lista de parâmetros, o valor do índice deve ser sempre 0, 1 ou 2. Se não houver parâmetro na posição do índice , a FormatException é lançado.
,comprimento	O número mínimo de caracteres na representação string do parâmetro. Se for positivo, o parâmetro está alinhado à direita; se for negativo, está alinhado à esquerda.
:formatString	Uma string de formato padrão ou personalizada suportada pelo objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores suportados pelo método do `ToString(string format)` objeto. Se o formatString não for especificado e o objeto a formatar implementar a IFormattable interface, `null` é passado como o valor do `format` parâmetro usado como string IFormattable.ToString de formato.

Os caracteres de colte inicial e final, "{" e "}", são obrigatórios. Para especificar um único carácter literal de coltese em format, especifique dois caracteres de colchetes iniciais ou de fim; ou seja, "{{" ou "}}".

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de formato, é ignorado.

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

Ver também

Aplica-se a

Write(String, Object, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve uma string formatada no fluxo de texto usando a mesma semântica do Format(String, Object, Object) método.

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

arg0: Object

O primeiro objeto a formatar e a escrever.

arg1: Object

O segundo objeto: formatar e escrever.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

FormatException

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

-ou-

O índice de um item de formato é inferior a 0 (zero) ou maior ou igual ao número de objetos a formatar (que, para este método de sobrecarga, é dois).

Observações

Para mais informações sobre a funcionalidade de formatação composta, consulte Formatação composta.
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre especificadores de formato de data e hora, consulte Cadeias de Formato de Data e Hora Padrão e Cadeias de Formato de Data e Hora Personalizadas.
Para mais informações sobre especificadores de formato de enumeração, consulte Strings de Formato de Enumeração.
Para 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
indexar	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 é substituído por String.Empty. Como esta sobrecarga tem dois objetos na sua lista de parâmetros, o valor do índice deve ser sempre 0 ou 1. Se não houver parâmetro na posição do índice , a FormatException é lançado.
,comprimento	O número mínimo de caracteres na representação string do parâmetro. Se for positivo, o parâmetro está alinhado à direita; se for negativo, está alinhado à esquerda.
:formatString	Uma string de formato padrão ou personalizada suportada pelo objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores suportados pelo método do `ToString(string format)` objeto. Se o formatString não for especificado e o objeto a formatar implementar a IFormattable interface, `null` é passado como o valor do `format` parâmetro usado como string IFormattable.ToString de formato.

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de formato, é ignorado.

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

Ver também

Aplica-se a

Write(Char[], Int32, Int32)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve um 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[]

O array de caracteres para escrever dados.

index: Int32

A posição do carácter no buffer onde começar a recolher dados.

count: Int32

O número de caracteres a escrever.

Exceções

ArgumentException

O comprimento do buffer menos index é menor que count.

ArgumentNullException

O buffer parâmetro é null.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

Este método irá escrever count caracteres de dados a TextWriter partir do buffer array de caracteres a partir da posição index.

Esta sobrecarga é equivalente à Write(Char[]) sobrecarga para cada carácter entre bufferindex e (index + count).

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

Ver também

Aplica-se a

Write(String, ReadOnlySpan<Object>)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve uma string 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 formato composto.

arg: ReadOnlySpan<Object>

Um espaço de objetos que contém zero ou mais objetos para formatar e escrever.

Aplica-se a

Write(String, Object[])

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

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

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

arg: Object[]

Um array de objetos que contém zero ou mais objetos para formatar e escrever.

Exceções

ArgumentNullException

format ou arg é null.

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

FormatException

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

-ou-

O índice de um item de formato é inferior a 0 (zero), ou maior ou igual ao comprimento do arg array.

Observações

Para mais informações sobre a funcionalidade de formatação composta, consulte Formatação composta.
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre especificadores de formato de data e hora, consulte Cadeias de Formato de Data e Hora Padrão e Cadeias de Formato de Data e Hora Personalizadas.
Para mais informações sobre especificadores de formato de enumeração, consulte Strings de Formato de Enumeração.
Para 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
indexar	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 é substituído por String.Empty. Como esta sobrecarga tem um array na sua lista de parâmetros, o valor do índice deve ser sempre inferior ao comprimento do array. Se não houver parâmetro na posição do índice , a FormatException é lançado.
,comprimento	O número mínimo de caracteres na representação string do parâmetro. Se for positivo, o parâmetro está alinhado à direita; se for negativo, está alinhado à esquerda.
:formatString	Uma string de formato padrão ou personalizada suportada pelo objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores suportados pelo método do `ToString(string format)` objeto. Se o formatString não for especificado e o objeto a formatar implementar a IFormattable interface, `null` é passado como o valor do `format` parâmetro usado como string IFormattable.ToString de formato.

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de formato, é ignorado.

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

Ver também

Aplica-se a

Write(String, Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve uma cadeia formatada no fluxo de texto, usando a mesma semântica do Format(String, Object) método.

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

arg0: Object

O objetivo de formatar e escrever.

Exceções

ArgumentNullException

format é null.

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

FormatException

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

-ou-

O índice de um item de formato é inferior a 0 (zero), ou maior ou igual ao número de objetos a formatar (que, para este método de sobrecarga, é um).

Observações

Para mais informações sobre a funcionalidade de formatação composta, consulte Formatação composta.
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre especificadores de formato de data e hora, consulte Cadeias de Formato de Data e Hora Padrão e Cadeias de Formato de Data e Hora Personalizadas.
Para mais informações sobre especificadores de formato de enumeração, consulte Strings de Formato de Enumeração.
Para 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
indexar	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 é substituído por String.Empty. Como esta sobrecarga tem apenas um objeto na sua lista de parâmetros, o valor do índice deve ser sempre 0. Se não houver parâmetro na posição do índice , a FormatException é lançado.
,comprimento	O número mínimo de caracteres na representação string do parâmetro. Se for positivo, o parâmetro está alinhado à direita; se for negativo, está alinhado à esquerda.
:formatString	Uma string de formato padrão ou personalizada suportada pelo objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores suportados pelo método do `ToString(string format)` objeto. Se o formatString não for especificado e o objeto a formatar implementar a IFormattable interface, `null` é passado como o valor do `format` parâmetro usado como string IFormattable.ToString de formato.

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de formato, é ignorado.

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

Ver também

Aplica-se a

Write(UInt64)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Importante

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

Escreve a representação textual 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 para escrever.

Atributos: CLSCompliantAttribute

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o UInt64.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Write(UInt32)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Importante

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

Escreve a representação textual 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 escrever.

Atributos: CLSCompliantAttribute

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o UInt32.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Write(StringBuilder)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve um construtor de cadeias 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, como construtora de cadeias, para escrever no fluxo de texto.

Observações

Este método é equivalente a Write(stringBuilder.ToString()), mas utiliza o StringBuilder.GetChunks método para evitar criar a corda intermédia.

Aplica-se a

Write(Rune)

Origem:: TextWriter.cs

public:
 virtual void Write(System::Text::Rune value);

public virtual void Write(System.Text.Rune value);

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

Public Overridable Sub Write (value As Rune)

Parâmetros

value: Rune

Aplica-se a

Write(String)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve uma cadeia 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 sequência para escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

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

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por TextWriter.NewLine.

Se value for null, nada é escrito no fluxo de texto.

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

Ver também

Aplica-se a

Write(Decimal)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve a representação textual 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 escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

Ver também

Aplica-se a

Write(ReadOnlySpan<Char>)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve um espaço 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>

A extensão das personagens para a escrita.

Observações

A representação em texto do valor especificado é produzida ao chamar o ReadOnlySpan<Char>. Método ToString .

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

Aplica-se a

Write(Object)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve a representação textual de um objeto no fluxo de texto chamando o ToString método 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 escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

Esta sobrecarga é equivalente à Write(String) sobrecarga.

Se o objeto especificado for null, nenhuma ação é tomada e nenhuma exceção é lançada. Caso contrário, o método do ToString objeto é chamado para produzir a representação da cadeia, e a cadeia resultante é então escrita no fluxo de saída. A FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Write(Int64)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve a representação textual 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 assinado de 8 bytes para escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o Int64.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Como: Gravar texto em um arquivo

Ver também

Aplica-se a

Write(Int32)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve a representação textual 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 assinado de 4 bytes para escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o Int32.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Write(Double)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava a representação textual de um valor de vírgula 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 escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o Double.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Write(Char[])

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve um array 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[]

O array de caracteres para escrever no fluxo de texto.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

Este método não procura na cadeia especificada caracteres individuais de nova linha (0x000a hexadecimal) e não os substitui por NewLine.

Este método padrão chama o Write(Char[], Int32, Int32) método e passa todo o array de caracteres. Se o array de caracteres for null, nada é escrito.

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

Ver também

Aplica-se a

Write(Char)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve um carácter 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 carácter a escrever no fluxo de texto.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

Este método padrão não faz nada, mas classes derivadas podem sobrepor o método para fornecer a funcionalidade adequada.

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

Ver também

Aplica-se a

Write(Boolean)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Escreve a representação textual de um Boolean valor 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 Boolean valor a escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o Boolean.ToString método.

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

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

Ver também

Aplica-se a

Write(Single)

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Origem:: TextWriter.cs

Grava a representação textual de um valor de vírgula 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 escrever.

Exceções

ObjectDisposedException

Está TextWriter fechado.

IOException

Ocorre um erro de E/S.

Observações

A representação textual do valor especificado é produzida ao chamar o Single.ToString método. A TextWriter.FormatProvider propriedade, se não nullfor , especifica a formatação específica da cultura.

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

Ver também

Aplica-se a

Comentários

Esta página foi útil?