TextWriter.Write Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Scrive i dati in un flusso di testo.

Overload

Write(String, Object, Object, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Scrive una sottomaschera di caratteri nel flusso di testo.
Write(String, Object[])	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object[]).
Write(String, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object).
Write(UInt64)	Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo.
Write(UInt32)	Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte.
Write(StringBuilder)	Scrive un generatore di stringhe nel flusso di testo.
Write(String)	Scrive una stringa nel flusso di testo.
Write(Single)	Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo.
Write(String, Object, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object, Object).
Write(Object)	Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il metodo ToString su tale oggetto.
Write(Int64)	Scrive la rappresentazione testuale di un intero con segno a 8 byte nel flusso di testo.
Write(Int32)	Scrive la rappresentazione testuale di un intero con segno a 4 byte nel flusso di testo.
Write(Double)	Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo.
Write(Decimal)	Scrive la rappresentazione testuale di un valore decimale nel flusso di testo.
Write(Char[])	Scrive una matrice di caratteri nel flusso di testo.
Write(Char)	Scrive un carattere nel flusso di testo.
Write(Boolean)	Scrive nel flusso di testo la rappresentazione testuale di un valore Boolean.
Write(ReadOnlySpan<Char>)	Scrive un intervallo di caratteri nel flusso di testo.

Write(String, Object, Object, Object)

Origine:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

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

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parametri

format

String

Stringa di formato composito.

arg0

Object

Primo oggetto da formattare e scrivere.

arg1

Object

Secondo oggetto da formattare e scrivere.

arg2

Object

Terzo oggetto da formattare e scrivere.

Eccezioni

ArgumentNullException

format è null.

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

FormatException

format non è una stringa di formato composito valida.

-o-

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, è tre).

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e per incorporare tale rappresentazione in una stringa. .NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

• Per altre informazioni sulla funzionalità di formattazione composita, vedere formattazione composita.

• Per altre informazioni sugli identificatori di formato numerico, vedere stringhe di formato numerico standard e stringhe di formato numerico personalizzato.

• Per altre informazioni sugli identificatori di formato di data e ora, vedere stringhe di formato di data e ora standard e stringhe di formato di data e ora personalizzate.

• Per altre informazioni sugli identificatori di formato di enumerazione, vedere stringhe di formato di enumerazione .

• Per altre informazioni sulla formattazione, vedere Tipi di formattazione.

Il parametro format è costituito da zero o più esecuzioni di testo mescolate 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 è la seguente:

{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi. La tabella seguente descrive ogni elemento. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.

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 include tre oggetti nell'elenco di parametri, il valore di indice deve essere sempre 0, 1 o 2. Se non è presente alcun parametro nella posizione dell'indice , viene generata una .
,lunghezza	Numero minimo di caratteri nella rappresentazione di stringa del parametro. Se positivo, il parametro è allineato a destra; se negativo, è allineato a sinistra.
:formatString	Stringa di formato standard o personalizzata supportata dall'oggetto da formattare. I valori possibili per formatString sono gli stessi dei valori supportati dal metodo ToString(string format) dell'oggetto. Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format utilizzato come stringa di formato IFormattable.ToString.

Sono necessari i caratteri di parentesi graffa iniziale e finale, "{" e "}". Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due caratteri di parentesi graffa iniziale o finale; ovvero "{{" o "}}".

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con TextWriter.NewLine.

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

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Char[], Int32, Int32)

Origine:

TextWriter.cs

Scrive una sottomaschera di caratteri nel flusso di testo.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Parametri

buffer

Char[]

Matrice di caratteri da cui scrivere i dati.

index

Int32

Posizione del carattere nel buffer in cui iniziare a recuperare i dati.

count

Int32

Numero di caratteri da scrivere.

Eccezioni

ArgumentException

La lunghezza del buffer meno index è minore di count.

ArgumentNullException

Il parametro buffer è null.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo metodo scriverà count caratteri di dati in questo TextWriter dalla matrice di caratteri buffer a partire dalla posizione index.

Questo overload equivale all'overload Write(Char[]) per ogni carattere in buffer tra index e (index + count).

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

Vedi anche

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(String, Object[])

Origine:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

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

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

Parametri

format

String

Stringa di formato composito.

arg

Object[]

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

Eccezioni

ArgumentNullException

format o arg è null.

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

FormatException

format non è una stringa di formato composito valida.

-o-

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

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e per incorporare tale rappresentazione in una stringa. .NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

• Per altre informazioni sulla funzionalità di formattazione composita, vedere formattazione composita.

• Per altre informazioni sugli identificatori di formato numerico, vedere stringhe di formato numerico standard e stringhe di formato numerico personalizzato.

• Per altre informazioni sugli identificatori di formato di data e ora, vedere stringhe di formato di data e ora standard e stringhe di formato di data e ora personalizzate.

• Per altre informazioni sugli identificatori di formato di enumerazione, vedere stringhe di formato di enumerazione .

• Per altre informazioni sulla formattazione, vedere Tipi di formattazione.

Il parametro format è costituito da zero o più esecuzioni di testo mescolate 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 è la seguente:

{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi. La tabella seguente descrive ogni elemento. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.

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 include una matrice nel relativo elenco di parametri, il valore di indice deve essere sempre minore della lunghezza della matrice. Se non è presente alcun parametro nella posizione dell'indice , viene generata una .
,lunghezza	Numero minimo di caratteri nella rappresentazione di stringa del parametro. Se positivo, il parametro è allineato a destra; se negativo, è allineato a sinistra.
:formatString	Stringa di formato standard o personalizzata supportata dall'oggetto da formattare. I valori possibili per formatString sono gli stessi dei valori supportati dal metodo ToString(string format) dell'oggetto. Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format utilizzato come stringa di formato IFormattable.ToString.

Sono necessari i caratteri di parentesi graffa iniziale e finale, "{" e "}". Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due caratteri di parentesi graffa iniziale o finale; ovvero "{{" o "}}".

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con TextWriter.NewLine.

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

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(String, Object)

Origine:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Parametri

format

String

Stringa di formato composito.

arg0

Object

Oggetto da formattare e scrivere.

Eccezioni

ArgumentNullException

format è null.

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

FormatException

format non è una stringa di formato composito valida.

-o-

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

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e per incorporare tale rappresentazione in una stringa. .NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

• Per altre informazioni sulla funzionalità di formattazione composita, vedere formattazione composita.

• Per altre informazioni sugli identificatori di formato numerico, vedere stringhe di formato numerico standard e stringhe di formato numerico personalizzato.

• Per altre informazioni sugli identificatori di formato di data e ora, vedere stringhe di formato di data e ora standard e stringhe di formato di data e ora personalizzate.

• Per altre informazioni sugli identificatori di formato di enumerazione, vedere stringhe di formato di enumerazione .

• Per altre informazioni sulla formattazione, vedere Tipi di formattazione.

Il parametro format è costituito da zero o più esecuzioni di testo mescolate 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 è la seguente:

{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi. La tabella seguente descrive ogni elemento. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.

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 include solo un singolo oggetto nell'elenco dei parametri, il valore di index deve essere sempre 0. Se non è presente alcun parametro nella posizione dell'indice , viene generata una .
,lunghezza	Numero minimo di caratteri nella rappresentazione di stringa del parametro. Se positivo, il parametro è allineato a destra; se negativo, è allineato a sinistra.
:formatString	Stringa di formato standard o personalizzata supportata dall'oggetto da formattare. I valori possibili per formatString sono gli stessi dei valori supportati dal metodo ToString(string format) dell'oggetto. Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format utilizzato come stringa di formato IFormattable.ToString.

Sono necessari i caratteri di parentesi graffa iniziale e finale, "{" e "}". Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due caratteri di parentesi graffa iniziale o finale; ovvero "{{" o "}}".

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con TextWriter.NewLine.

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

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(UInt64)

Origine:

TextWriter.cs

Importante

Questa API non è conforme a CLS.

Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Parametri

value

UInt64

Intero senza segno a 8 byte da scrivere.

Attributi

CLSCompliantAttribute

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo UInt64.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(UInt32)

Origine:

TextWriter.cs

Importante

Questa API non è conforme a CLS.

Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Parametri

value

UInt32

Intero senza segno a 4 byte da scrivere.

Attributi

CLSCompliantAttribute

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo UInt32.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(StringBuilder)

Origine:

TextWriter.cs

Scrive un generatore di stringhe nel flusso di testo.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Parametri

value

StringBuilder

Stringa, come generatore di stringhe, da scrivere nel flusso di testo.

Commenti

Questo metodo equivale a Write(stringBuilder.ToString()), ma usa il metodo StringBuilder.GetChunks per evitare di creare la stringa intermedia.

Write(String)

Origine:

TextWriter.cs

Scrive una stringa nel flusso di testo.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Parametri

value

String

Stringa da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo overload equivale all'overload Write(Char[]).

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con TextWriter.NewLine.

Se value è null, non viene scritto nulla nel flusso di testo.

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

Vedi anche

• Write(String)
• Write(String)
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Single)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Parametri

value

Single

Valore a virgola mobile a 4 byte da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Single.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(String, Object, Object)

Origine:

TextWriter.cs

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

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

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

Parametri

format

String

Stringa di formato composito.

arg0

Object

Primo oggetto da formattare e scrivere.

arg1

Object

Secondo oggetto da formattare e scrivere.

Eccezioni

ArgumentNullException

format è null.

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

FormatException

format non è una stringa di formato composito valida.

-o-

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, è due).

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e per incorporare tale rappresentazione in una stringa. .NET offre un supporto completo per la formattazione, descritto in modo più dettagliato negli argomenti di formattazione seguenti:

• Per altre informazioni sulla funzionalità di formattazione composita, vedere formattazione composita.

• Per altre informazioni sugli identificatori di formato numerico, vedere stringhe di formato numerico standard e stringhe di formato numerico personalizzato.

• Per altre informazioni sugli identificatori di formato di data e ora, vedere stringhe di formato di data e ora standard e stringhe di formato di data e ora personalizzate.

• Per altre informazioni sugli identificatori di formato di enumerazione, vedere stringhe di formato di enumerazione .

• Per altre informazioni sulla formattazione, vedere Tipi di formattazione.

Il parametro format è costituito da zero o più esecuzioni di testo mescolate 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 è la seguente:

{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi. La tabella seguente descrive ogni elemento. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.

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 include due oggetti nell'elenco di parametri, il valore di indice deve essere sempre 0 o 1. Se non è presente alcun parametro nella posizione dell'indice , viene generata una .
,lunghezza	Numero minimo di caratteri nella rappresentazione di stringa del parametro. Se positivo, il parametro è allineato a destra; se negativo, è allineato a sinistra.
:formatString	Stringa di formato standard o personalizzata supportata dall'oggetto da formattare. I valori possibili per formatString sono gli stessi dei valori supportati dal metodo ToString(string format) dell'oggetto. Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format utilizzato come stringa di formato IFormattable.ToString.

Sono necessari i caratteri di parentesi graffa iniziale e finale, "{" e "}". Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due caratteri di parentesi graffa iniziale o finale; ovvero "{{" o "}}".

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con TextWriter.NewLine.

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

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Object)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il metodo ToString su tale oggetto.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Parametri

value

Object

Oggetto da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo overload equivale all'overload Write(String).

Se l'oggetto specificato è null, non viene eseguita alcuna azione e non viene generata alcuna eccezione. In caso contrario, viene chiamato il metodo ToString dell'oggetto per produrre la rappresentazione di stringa e la stringa risultante viene quindi scritta nel flusso di output. La proprietà FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Int64)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un intero con segno a 8 byte nel flusso di testo.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Parametri

value

Int64

Intero con segno a 8 byte da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Int64.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Procedura: Scrivere testo in un di file

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un intero con segno a 4 byte nel flusso di testo.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Parametri

value

Int32

Intero con segno a 4 byte da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Int32.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Double)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Parametri

value

Double

Valore a virgola mobile a 8 byte da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Double.ToString. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Decimal)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Parametri

value

Decimal

Valore decimale da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La proprietà FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Char[])

Origine:

TextWriter.cs

Scrive una matrice di caratteri nel flusso di testo.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Parametri

buffer

Char[]

Matrice di caratteri da scrivere nel flusso di testo.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo metodo non cerca nella stringa specificata i singoli caratteri di nuova riga (0x000a esadecimali) e li sostituisce con NewLine.

Questo metodo predefinito chiama il metodo Write(Char[], Int32, Int32) e passa l'intera matrice di caratteri. Se la matrice di caratteri è null, non viene scritto nulla.

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

Vedi anche

• Write(Char[])
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Char)

Origine:

TextWriter.cs

Scrive un carattere nel flusso di testo.

public:
 virtual void Write(char value);

public virtual void Write (char value);

abstract member Write : char -> unit
override this.Write : char -> unit

Public Overridable Sub Write (value As Char)

Parametri

value

Char

Carattere da scrivere nel flusso di testo.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo metodo predefinito non esegue alcuna operazione, ma le classi derivate possono eseguire l'override del metodo per fornire le funzionalità appropriate.

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

Vedi anche

• Write(Char)
• Write(Char)
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(Boolean)

Origine:

TextWriter.cs

Scrive nel flusso di testo la rappresentazione testuale di un valore Boolean.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Parametri

value

Boolean

Valore Boolean da scrivere.

Eccezioni

ObjectDisposedException

Il TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Boolean.ToString.

Questo metodo restituisce Boolean.TrueString o Boolean.FalseString.

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

Vedi anche

• StreamWriter
• StringWriter
• di I/O di flusso e file
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un di file

Write(ReadOnlySpan<Char>)

Origine:

TextWriter.cs

Scrive un intervallo di caratteri nel flusso di testo.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Parametri

buffer

ReadOnlySpan<Char>

Intervallo di caratteri da scrivere.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il ReadOnlySpan<Char>. Metodo ToString.

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