TextWriter.Write Método

Definição

Grava dados em um fluxo de texto.Writes data to a text stream.

Sobrecargas

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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32)

Grava uma submatriz de caracteres no fluxo de texto.Writes a subarray of characters to the text stream.

Write(String, Object[])

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do método Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object)

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do método Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64)

Grava a representação de texto de um inteiro sem sinal de 8 bytes no fluxo de texto.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

Grava a representação de texto de um inteiro sem sinal de 4 bytes no fluxo de texto.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

Grava um construtor de cadeia de caracteres no fluxo de texto.Writes a string builder to the text stream.

Write(String)

Grava uma cadeia de caracteres no fluxo de texto.Writes a string to the text stream.

Write(Single)

Grava a representação de texto de um valor de ponto flutuante de 4 bytes no fluxo de texto.Writes the text representation of a 4-byte floating-point value to the text stream.

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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object)

Grava a representação de texto de um objeto no fluxo de texto chamando o método ToString nesse objeto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64)

Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

Grava a representação de texto de um valor de ponto flutuante de 8 bytes no fluxo de texto.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

Grava a representação de texto de um valor decimal no fluxo de texto.Writes the text representation of a decimal value to the text stream.

Write(Char[])

Grava uma matriz de caracteres no fluxo de texto.Writes a character array to the text stream.

Write(Char)

Grava um caractere no fluxo de texto.Writes a character to the text stream.

Write(Boolean)

Grava a representação de texto de um valor Boolean no fluxo de texto.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

Grava um intervalo de caracteres no fluxo de texto.Writes a character span to the text stream.

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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

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.A composite format string.

arg0
Object

O primeiro objeto a ser formatado e gravado.The first object to format and write.

arg1
Object

O segundo objeto a ser formatado e gravado.The second object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- 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).The index of a format item is less than 0 (zero) or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

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.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

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.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

{index[,Length] [:FormatString]}{index[,length][:formatString]}

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem dois objetos em sua lista de parâmetros, o valor do índice deve ser sempre 0 ou 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 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.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Char[], Int32, Int32)

Grava uma submatriz de caracteres no fluxo de texto.Writes a subarray of characters to the text stream.

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.The character array to write data from.

index
Int32

A posição do caractere no buffer em que iniciar a recuperação de dados.The character position in the buffer at which to start retrieving data.

count
Int32

O número de caracteres a serem gravados.The number of characters to write.

Exceções

O tamanho do buffer menos index é menor que count.The buffer length minus index is less than count.

O parâmetro buffer é null.The buffer parameter is null.

index ou count é negativo.index or count is negative.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Esse método gravará count caracteres de dados nele TextWriter a partir da buffer matriz de caracteres começando na posição index .This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Essa sobrecarga é equivalente à Write(Char[]) sobrecarga para cada caractere buffer entre index e ( index + count ).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(String, Object[])

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do método Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

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.A composite format string.

arg
Object[]

Uma matriz de objetos que contém zero ou mais objetos a serem formatados e gravados.An object array that contains zero or more objects to format and write.

Exceções

format ou arg é null.format or arg is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- O índice de um item de formato é menor que 0 (zero) ou maior ou igual ao tamanho da matriz arg.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

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.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

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.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

{index[,Length] [:FormatString]}{index[,length][:formatString]}

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem uma matriz em sua lista de parâmetros, o valor do índice deve ser sempre menor que o comprimento da matriz.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 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.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(String, Object)

Grava uma cadeia de caracteres formatada no fluxo de texto usando a mesma semântica do método Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

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.A composite format string.

arg0
Object

O objeto a ser formatado e gravado.The object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- 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).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

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.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

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.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

{index[,Length] [:FormatString]}{index[,length][:formatString]}

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. Como essa sobrecarga tem apenas um único objeto em sua lista de parâmetros, o valor de index deve ser sempre 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 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.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(UInt64)

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.Writes the text representation of an 8-byte unsigned integer to the text stream.

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.The 8-byte unsigned integer to write.

Atributos

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o UInt64.ToString método.The text representation of the specified value is produced by calling the UInt64.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(UInt32)

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.Writes the text representation of a 4-byte unsigned integer to the text stream.

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.The 4-byte unsigned integer to write.

Atributos

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o UInt32.ToString método.The text representation of the specified value is produced by calling the UInt32.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(StringBuilder)

Grava um construtor de cadeia de caracteres no fluxo de texto.Writes a string builder to the text stream.

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.The string, as a string builder, to write to the text stream.

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.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Aplica-se a

Write(String)

Grava uma cadeia de caracteres no fluxo de texto.Writes a string to the text stream.

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.The string to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Essa sobrecarga é equivalente à Write(Char[]) sobrecarga.This overload is equivalent to the Write(Char[]) overload.

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se value for null, nada será gravado no fluxo de texto.If value is null, nothing is written to the text stream.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Single)

Grava a representação de texto de um valor de ponto flutuante de 4 bytes no fluxo de texto.Writes the text representation of a 4-byte floating-point value to the text stream.

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.The 4-byte floating-point value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Single.ToString método.The text representation of the specified value is produced by calling the Single.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

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.A composite format string.

arg0
Object

O primeiro objeto a ser formatado e gravado.The first object to format and write.

arg1
Object

O segundo objeto a ser formatado e gravado.The second object to format and write.

arg2
Object

O terceiro objeto a ser formatado e gravado.The third object to format and write.

Exceções

format é null.format is null.

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

format não é uma cadeia de caracteres de formato de composição válida.format is not a valid composite format string.

- ou --or- 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).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

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.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. O .NET fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

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.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. O processo de formatação substitui cada item de formato pela representação de cadeia de caracteres do valor do objeto correspondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

A sintaxe de um item de formato é a seguinte:The syntax of a format item is as follows:

{index[,Length] [:FormatString]}{index[,length][:formatString]}

Os elementos entre colchetes são opcionais.Elements in square brackets are optional. A tabela a seguir descreve cada elemento.The following table describes each element. Para obter mais informações sobre o recurso de formatação composta, incluindo a sintaxe de um item de formato, consulte formatação composta.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescriçãoDescription
índiceindex A posição de base zero na lista de parâmetros do objeto a ser formatado.The zero-based position in the parameter list of the object to be formatted. Se o objeto especificado por index for null , o item de formato será substituído por String.Empty .If the object specified by index is null, the format item is replaced by 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.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Se não houver nenhum parâmetro na posição do índice , um FormatException será gerado.If there is no parameter in the index position, a FormatException is thrown.
,comprimento,length O número mínimo de caracteres na representação da cadeia de caracteres do parâmetro.The minimum number of characters in the string representation of the parameter. Se positivo, o parâmetro será alinhado à direita; Se for negativo, ele será alinhado à esquerda.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Uma cadeia de caracteres de formato padrão ou personalizada que é suportada pelo objeto a ser formatado.A standard or custom format string that is supported by the object to be formatted. Os valores possíveis para FormatString são os mesmos que os valores com suporte pelo método do objeto ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 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.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

Os caracteres de chave à esquerda e à direita, "{" e "}", são necessários.The leading and trailing brace characters, "{" and "}", are required. Para especificar um único caractere de chave literal no format , especifique dois caracteres de chave à esquerda ou à direita; ou seja, "{{" ou "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por TextWriter.NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se um objeto especificado não for referenciado na cadeia de caracteres de formato, ele será ignorado.If a specified object is not referenced in the format string, it is ignored.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Object)

Grava a representação de texto de um objeto no fluxo de texto chamando o método ToString nesse objeto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

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.The object to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Essa sobrecarga é equivalente à Write(String) sobrecarga.This overload is equivalent to the Write(String) overload.

Se o objeto especificado for null , nenhuma ação será executada e nenhuma exceção será gerada.If the specified object is null, no action is taken and no exception is thrown. Caso contrário, o método do objeto ToString será chamado para produzir a representação da cadeia de caracteres e a cadeia de caracteres resultante será gravada no fluxo de saída.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Int64)

Grava a representação de texto de um inteiro com sinal de 8 bytes no fluxo de texto.Writes the text representation of an 8-byte signed integer to the text stream.

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.The 8-byte signed integer to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Int64.ToString método.The text representation of the specified value is produced by calling the Int64.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Como: gravar texto em um arquivoHow to: Write Text to a File

Confira também

Aplica-se a

Write(Int32)

Grava a representação de texto de um inteiro com sinal de 4 bytes no fluxo de texto.Writes the text representation of a 4-byte signed integer to the text stream.

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.The 4-byte signed integer to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Int32.ToString método.The text representation of the specified value is produced by calling the Int32.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Double)

Grava a representação de texto de um valor de ponto flutuante de 8 bytes no fluxo de texto.Writes the text representation of an 8-byte floating-point value to the text stream.

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.The 8-byte floating-point value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Double.ToString método.The text representation of the specified value is produced by calling the Double.ToString method. A TextWriter.FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Decimal)

Grava a representação de texto de um valor decimal no fluxo de texto.Writes the text representation of a decimal value to the text stream.

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.The decimal value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A FormatProvider propriedade, se não null , especifica a formatação específica da cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Confira também

Aplica-se a

Write(Char[])

Grava uma matriz de caracteres no fluxo de texto.Writes a character array to the text stream.

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.The character array to write to the text stream.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Esse método não pesquisa a cadeia especificada para caracteres de nova linha individuais (0x000a hexadecimal) e os substitui por NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Esse método padrão chama o Write(Char[], Int32, Int32) método e passa a matriz de caracteres inteira.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Se a matriz de caracteres for null , nada será gravado.If the character array is null, nothing is written.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Char)

Grava um caractere no fluxo de texto.Writes a character to the text stream.

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.The character to write to the text stream.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

Esse método padrão não faz nada, mas classes derivadas podem substituir o método para fornecer a funcionalidade apropriada.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(Boolean)

Grava a representação de texto de um valor Boolean no fluxo de texto.Writes the text representation of a Boolean value to the text stream.

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.The Boolean value to write.

Exceções

O TextWriter está fechado.The TextWriter is closed.

Ocorre um erro de E/S.An I/O error occurs.

Comentários

A representação de texto do valor especificado é produzida chamando o Boolean.ToString método.The text representation of the specified value is produced by calling the Boolean.ToString method.

Esse método gera uma saída Boolean.TrueString de ou Boolean.FalseString .This method outputs either Boolean.TrueString or Boolean.FalseString.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Confira também

Aplica-se a

Write(ReadOnlySpan<Char>)

Grava um intervalo de caracteres no fluxo de texto.Writes a character span to the text stream.

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.The character span to write.

Comentários

A representação de texto do valor especificado é produzida chamando o ReadOnlySpan . Método ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Para obter uma lista de tarefas comuns de e/s, consulte tarefas comuns de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Aplica-se a