Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo TextWriter.Write (String, Object, Object, Object)

 

Data di pubblicazione: ottobre 2016

Scrive una stringa formattata nella stringa o nel flusso di testo, usando la stessa semantica del metodo String.Format(String, Object, Object, Object).

Spazio dei nomi:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

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

Parametri

format
Type: System.String

Stringa in formato composito (vedere la sezione Note).

arg0
Type: System.Object

Primo oggetto da formattare e scrivere.

arg1
Type: System.Object

Secondo oggetto da formattare e scrivere.

arg2
Type: System.Object

Terzo oggetto da formattare e scrivere.

Exception Condition
ArgumentNullException

format è null.

ObjectDisposedException

TextWriter è chiuso.

IOException

Si è verificato un errore di I/O.

FormatException

format non è una stringa di formato composto valido.

-oppure-

L'indice di un elemento di formato è minore di 0 (zero), oppure maggiore o uguale al numero di oggetti da formattare (ovvero, per questo overload del metodo, tre).

Questo metodo utilizza il di .NET Framework per convertire il valore di un oggetto nella relativa rappresentazione di stringa e incorporare tale rappresentazione in una stringa. .NET Framework fornisce supporto di formattazione completo, descritto più dettagliatamente negli argomenti di formattazione seguenti:

Il format parametro consiste di zero o più esecuzioni di testo combinato con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco dei parametri di questo metodo. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.

La sintassi di un elemento di formato è come segue:

{indice[,lunghezza] [:formatString]}

Gli elementi racchiusa tra parentesi quadre sono facoltativi. Nella tabella seguente viene descritto ogni elemento. Per ulteriori informazioni sulle funzionalità, inclusa la sintassi di un elemento di formato, di formattazione composta vedere Formattazione composita.

Elemento

Descrizione

indice

Posizione nell'elenco dei parametri in base zero dell'oggetto da formattare. Se l'oggetto specificato da indice è null, l'elemento di formato viene sostituito da String.Empty. Poiché questo overload presenta tre oggetti nel relativo parametro elenco, il valore di indice deve sempre essere 0, 1 o 2. Se non esiste alcun parametro nel indice posizione, un FormatException viene generata un'eccezione.

,lunghezza

Il numero minimo di caratteri nella rappresentazione di stringa del parametro. Se è positivo, il parametro è allineato a destra; Se è negativo, è allineato a sinistra.

:formatString

Una stringa di formato standard o personalizzato che è supportata dall'oggetto da formattare. I valori possibili per formatString sono gli stessi valori supportati per l'oggetto ToString(format) metodo. Se formatString non è specificato e l'oggetto da formattare implementa il IFormattable interfaccia, null viene passato come valore del format parametro viene utilizzato come il IFormattable.ToString stringa di formato.

Iniziali e finali parentesi graffe, "{" e "}", sono necessari. Per specificare un singolo valore letterale carattere parentesi graffa in format, specificare due iniziali o finali parentesi graffe; ovvero, "{{" o "}}".

Questo metodo non cerca la stringa specificata per i caratteri di nuova riga singola (esadecimale 0x000a) e sostituirle con TextWriter.NewLine.

Se un oggetto specificato non viene fatto riferimento nella stringa di formato, viene ignorato.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: