Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo TextWriter.Write (String, Object)

Scrive una stringa formattata in una riga in una stringa o un flusso di testo, utilizzando la stessa semantica del metodo di String.Format(String, Object) .

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

public virtual void Write(
	string format,
	Object arg0
)

Parametri

format
Tipo: System.String
Stringa in formato composto (vedere la sezione Osservazioni).
arg0
Tipo: System.Object
Oggetto da formattare e scrivere.

EccezioneCondizione
ArgumentNullException

format è null.

ObjectDisposedException

La classe TextWriter è chiusa.

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) o maggiore o uguale al numero di oggetti da formattare (che, per questo overload del metodo, è uno).

In questo metodo viene utilizzata la funzionalità di formattazione composta di .NET Framework per convertire il valore di un oggetto nella relativa rappresentazione in forma di stringa e per incorporare tale rappresentazione in una stringa. .NET Framework fornisce supporto di formattazione completo, descritto più dettagliatamente negli argomenti relativi alla formattazione riportati di seguito:

Il parametro format è costituito da zero o più sequenze di testo intervallate da 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 consente di sostituire ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.

La sintassi di un elemento di formato è la seguente:

{indice[,lunghezza] [:stringaFormato]}

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

Elemento

Descrizione

indice

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

,lunghezza

Il minimo numero di caratteri nella rappresentazione in forma di stringa del parametro. Se positivo, il parametro verrà allineato a destra; se negativo, verrà allineato a sinistra.

:stringaFormato

Stringa di formato standard o personalizzata supportata dall'oggetto da formattare. I valori possibili per formatString corrispondono ai valori supportati dal metodo ToString(format) dell'oggetto. Se formatString non è specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, viene passato null come valore del parametro format utilizzato come stringa di formato IFormattable.ToString.

Sono obbligatorie le parentesi graffe iniziali e finali, "{" e "}". Per specificare un singolo carattere effettivo parentesi graffa in format, specificare due parentesi iniziali o finali, ossia "{{" 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 nella stringa di formattazione non si fa riferimento a un oggetto specificato, questo viene ignorato.

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

.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft