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[])

 

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[]).

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

public virtual void Write(
	string format,
	params object[] arg
)

Parametri

format
Type: System.String

Stringa in formato composito (vedere la sezione Note).

arg
Type: System.Object[]

Matrice di oggetti che contiene zero o più oggetti da formattare e scrivere.

Exception Condition
ArgumentNullException

format o arg è null.

ObjectDisposedException

TextWriter è chiuso.

IOException

Si è verificato un errore di I/O.

FormatException

formatnon è una stringa di formato composto valido.

-oppure-

L'indice di un elemento di formato è minore di 0 (zero) oppure maggiore o uguale alla lunghezza del arg matrice.

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, come descritto in maggior dettaglio negli argomenti di formattazione seguenti:

Il format parametro è costituita da zero o più sequenze di testo combinato con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco di 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 è il seguente:

{index[,length][:formatString]}

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

Elemento

Descrizione

indice

Posizione nell'elenco di 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 dispone di una matrice nel parametro elenco, il valore di indice deve sempre essere minore della lunghezza della matrice. Se è presente 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 un valore negativo, è allineato a sinistra.

:formatString

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 implementa l'oggetto da formattare il IFormattable interfaccia, null viene passato come valore della format parametro viene utilizzato come il IFormattable.ToString stringa di formato.

Iniziali e finali di 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 "}}".

Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con TextWriter.NewLine.

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

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

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: