WriteLine Método (String, Object, Object, Object)
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.WriteLine (String, Object, Object, Object)

 

Grava uma cadeia de caracteres formatada e uma nova linha, usando a mesma semântica Format.

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

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

Parâmetros

format

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

arg0

O primeiro objeto para formatar e escrever.

arg1

O segundo objeto para formatar e escrever.

arg2

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 ou igual ao número de objetos a ser formatado (que, para essa sobrecarga de 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 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 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]}

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.  

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; Se for negativo, será alinhado à esquerda.  

:formatString

Uma cadeia de caracteres de formato padrão ou personalizado que é compatível com o objeto a ser formatado.  Os 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 é usado como o IFormattable.ToString cadeia de formato.  

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

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

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

O terminador de linha é definido pelo CoreNewLine campo.

Para obter uma lista de tarefas comuns de e/s, consulte Common I/O Tasks.

Universal Windows Platform
Disponível desde 10
.NET Framework
Disponível desde 1.1
Retornar ao topo
Mostrar:
© 2016 Microsoft