Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método TextWriter.Write (String, Object, Object, Object)

 

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

Namespace:   System.IO
Assembly:  mscorlib (em mscorlib.dll)

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

Parâmetros

format
Type: System.String

Uma cadeia de caracteres de formato composto (consulte comentários).

arg0
Type: System.Object

O primeiro objeto para formatar e escrever.

arg1
Type: System.Object

O segundo objeto para formatar e escrever.

arg2
Type: System.Object

O terceiro objeto para formatar e escrever.

Exception Condition
ArgumentNullException

format é null.

ObjectDisposedException

O TextWriter está fechado.

IOException

Ocorre um erro de e/s.

FormatException

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

- ou -

O índice de um item de formato é menor que 0 (zero) ou maior que ou igual ao número de objetos a serem formatados (que, para essa sobrecarga de método, três).

Esse método usa do .NET Framework 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 Framework fornece suporte extenso à formatação, que é descrita mais detalhadamente nos tópicos de formatação a seguir:

O format parâmetro consiste de zero ou mais execuções de texto misturado 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 com a representação de cadeia de caracteres do valor do objeto correspondente.

A sintaxe de um item de formato é o seguinte:

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

Elementos entre colchetes são opcionais. A tabela a seguir descreve cada elemento. Para obter mais informações sobre formatação de recurso, incluindo a sintaxe de um item de formato composto consulte Formatação composta.

ELEMENT

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 é null, o item de formato é substituído pelo String.Empty. Como essa sobrecarga tem três objetos no seu parâmetro de lista, o valor de índice sempre deve ser 0, 1 ou 2. Se não houver nenhum parâmetro de índice posição, um FormatException é lançada.

,comprimento

O número mínimo de caracteres na representação de cadeia de caracteres do parâmetro. Em caso positivo, o parâmetro é alinhado à direita; caso negativo, ele é alinhado à esquerda.

:formatString

Uma cadeia de caracteres de formato padrão ou personalizado que é compatível com o objeto a ser formatado. Valores possíveis para formatString são os mesmos que os valores com suporte do objeto ToString(format) método. Se formatString não for especificado e o objeto a ser formatado implementa a IFormattable interface, null é passado como o valor da format parâmetro que é usado como o IFormattable.ToString cadeia de caracteres de formato.

À esquerda e à direita de caracteres, de chaves "{" e "}", são necessários. Para especificar um caractere único chave literal em format, especifique dois à esquerda ou à direita de chaves caracteres; ou seja, "{{" ou "}}".

Esse método não pesquisar a cadeia de caracteres especificada por caracteres de nova linha individual (hexadecimal 0x000a) e substituí-los com TextWriter.NewLine.

Se um objeto especificado não é 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.

Plataforma Universal do Windows
Disponível desde 10
.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: