TextWriter.Write Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

netstandard.dll, System.Runtime.dll

Scrive i dati in un flusso di testo.

Overload

Nome	Descrizione
Write(String, Object, Object, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del Format(String, Object, Object, Object) metodo .
Write(String, Object, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del Format(String, Object, Object) metodo .
Write(Char[], Int32, Int32)	Scrive una sottomaschera di caratteri nel flusso di testo.
Write(String, ReadOnlySpan<Object>)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica di Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del Format(String, Object[]) metodo .
Write(String, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del Format(String, Object) metodo .
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(Decimal)	Scrive la rappresentazione testuale di un valore decimale nel flusso di testo.
Write(ReadOnlySpan<Char>)	Scrive un intervallo di caratteri nel flusso di testo.
Write(Object)	Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il ToString metodo 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(Char[])	Scrive una matrice di caratteri nel flusso di testo.
Write(Char)	Scrive un carattere nel flusso di testo.
Write(Boolean)	Scrive la rappresentazione testuale di un Boolean valore 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, Object)

Origine:

TextWriter.cs

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

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

L'oggetto 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 Formattazione dei tipi.

Il format parametro è 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 dall'indice è null, l'elemento di formato viene sostituito da String.Empty. Poiché questo overload include tre oggetti nell'elenco di parametri, il valore dell'indice deve essere sempre 0, 1 o 2. Se non è presente alcun parametro nella posizione dell'indice , viene generata un'eccezione FormatException .
,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 corrispondono ai valori supportati dal metodo dell'oggetto ToString(string format) . Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable , null viene passato come valore del format parametro utilizzato come IFormattable.ToString stringa di formato.

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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file

Write(String, Object, Object)

Origine:

TextWriter.cs

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

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

L'oggetto 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 Formattazione dei tipi.

Il format parametro è 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 dall'indice è null, l'elemento di formato viene sostituito da String.Empty. Poiché questo overload ha due oggetti nell'elenco di parametri, il valore di index deve essere sempre 0 o 1. Se non è presente alcun parametro nella posizione dell'indice , viene generata un'eccezione FormatException .
,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 corrispondono ai valori supportati dal metodo dell'oggetto ToString(string format) . Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable , null viene passato come valore del format parametro utilizzato come IFormattable.ToString stringa di formato.

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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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 buffer parametro è null.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

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

Questo overload equivale all'overload Write(Char[]) per ogni carattere tra indexbuffer e (countindex + ).

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)
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file

Write(String, ReadOnlySpan<Object>)

Origine:

TextWriter.cs

Scrive una stringa formattata nel flusso di testo usando la stessa semantica di Format(String, ReadOnlySpan<Object>).

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

public virtual void Write(string format, scoped ReadOnlySpan<object?> arg);

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

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

Parametri

format

String

Stringa di formato composito.

arg

ReadOnlySpan<Object>

Intervallo di oggetti contenente zero o più oggetti da formattare e scrivere.

Write(String, Object[])

Origine:

TextWriter.cs

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

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

L'oggetto 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 arg matrice.

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 Formattazione dei tipi.

Il format parametro è 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 dall'indice è null, l'elemento di formato viene sostituito da String.Empty. Poiché questo overload ha una matrice nel relativo elenco di parametri, il valore dell'indice deve essere sempre minore della lunghezza della matrice. Se non è presente alcun parametro nella posizione dell'indice , viene generata un'eccezione FormatException .
,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 corrispondono ai valori supportati dal metodo dell'oggetto ToString(string format) . Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable , null viene passato come valore del format parametro utilizzato come IFormattable.ToString stringa di formato.

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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file

Write(String, Object)

Origine:

TextWriter.cs

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

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

L'oggetto 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 Formattazione dei tipi.

Il format parametro è 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 dall'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 un'eccezione FormatException .
,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 corrispondono ai valori supportati dal metodo dell'oggetto ToString(string format) . Se formatString non viene specificato e l'oggetto da formattare implementa l'interfaccia IFormattable , null viene passato come valore del format parametro utilizzato come IFormattable.ToString stringa di formato.

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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il UInt64.ToString metodo . La TextWriter.FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il UInt32.ToString metodo . La TextWriter.FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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 StringBuilder.GetChunks metodo 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

L'oggetto 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)
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

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

Vedi anche

• StreamWriter
• StringWriter
• IFormatProvider
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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 readOnlySpan<Char>. Metodo ToString .

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

Write(Object)

Origine:

TextWriter.cs

Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il ToString metodo 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

L'oggetto 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 dell'oggetto ToString per produrre la rappresentazione di stringa e la stringa risultante viene quindi scritta nel flusso di output. La FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Int64.ToString metodo . La TextWriter.FormatProvider proprietà , 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 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Int32.ToString metodo . La TextWriter.FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Double.ToString metodo . La TextWriter.FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto 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 Write(Char[], Int32, Int32) metodo 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[])
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto 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)
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file

Write(Boolean)

Origine:

TextWriter.cs

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

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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

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

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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un 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

L'oggetto TextWriter è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Single.ToString metodo . La TextWriter.FormatProvider proprietà , 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
• I/O di file e stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file