Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

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

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

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

Parâmetros

format
Tipo: System.String
Uma cadeia de caracteres de formato composto (consulte comentários.)
arg0
Tipo: System.Object
O primeiro objeto a formatação e gravação.
arg1
Tipo: System.Object
O segundo objeto a formatação e gravação.
arg2
Tipo: System.Object
O terceiro objeto a formatação e gravação.

ExceçãoCondição
ArgumentNullException

format é null.

ObjectDisposedException

TextWriter é fechado.

IOException

Um erro de E/S ocorrerá.

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 ou igual ao número de objetos a ser formatado (que, para essa sobrecarga do método, é três).

Esse método usa o composto recurso formatação do .NET Framework para converter o valor de um objeto em sua representação de seqüência de caracteres e incorporar essa representação em uma seqüência de caracteres. O .NET Framework fornece amplo suporte de formatação, que é descrito mais detalhadamente nos seguintes tópicos de formatação:

O parâmetro de format consiste de zero ou mais execuções de texto misturadas com zero ou mais espaços reservados indexados, chamados de itens de formato, que correspondem a um objeto na lista de parâmetros do método. O processo de formatação substitui cada item de formato com a representação de cadeia de caracteres o valor do objeto correspondente.

A sintaxe de um item de formato é a seguinte:

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

Os elementos 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.

ELEMENT

Descrição

índice

A posição zero com base na lista de parâmetros do objeto ser formatado. Se o objeto especificado por índice é null, o item de formato é substituído por String.Empty. Porque essa sobrecarga tem três objetos em sua lista de parâmetros, o valor de índice deve sempre ser 0, 1, ou 2. Se não houver nenhum parâmetro na posição de índice , FormatException é lançada.

,comprimento

O número mínimo de caracteres na representação de cadeia de caracteres de parâmetro. Se o positivo, o parâmetro é alinhado; se o negativo, um ele é alinhado.

:formatString

Um padrão ou uma cadeia de caracteres de formato personalizado que é suportada pelo objeto a ser formatado. Os valores possíveis para formatString são os mesmos que os valores suportados pelo método de ToString(format) de objeto. Se formatString não é especificado e o objeto para ser formatado implementa a interface de IFormattable , null é passado como o valor do parâmetro de format que é usado como a cadeia de caracteres de formato de IFormattable.ToString .

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

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

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

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

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft