TextWriter.Write Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 sottomatrice 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 nel flusso di testo la rappresentazione testuale di un intero a 8 byte senza segno. |
Write(UInt32) |
Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte senza segno. |
Write(StringBuilder) |
Scrive un generatore di stringhe nel flusso di testo. |
Write(String) |
Scrive una stringa nel flusso di testo. |
Write(Single) |
Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 4 byte. |
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 nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo |
Write(Int64) |
Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte con segno. |
Write(Int32) |
Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte con segno. |
Write(Double) |
Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 8 byte. |
Write(Decimal) |
Scrive nel flusso di testo la rappresentazione testuale di un valore decimale. |
Write(Char[]) |
Scrive una matrice di caratteri nel flusso di testo. |
Write(Char) |
Scrive un carattere nel flusso di testo. |
Write(Boolean) |
Inserisce nel flusso di testo la rappresentazione testuale di un valore |
Write(ReadOnlySpan<Char>) |
Scrive un intervallo di caratteri nel flusso di testo. |
Write(String, Object, Object, Object)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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);
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 in 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
format
è null
.
TextWriter è chiuso.
Si è verificato un errore di I/O.
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, è 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 data e ora standard e stringhe di formato 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 i singoli elementi. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere Formattazione composita.
Elemento | Descrizione |
---|---|
index | 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 parentesi graffe iniziali o finali, 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 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Char[], Int32, Int32)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive una sottomatrice 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 da cui iniziare il recupero dei dati.
- count
- Int32
Numero di caratteri da scrivere.
Eccezioni
La lunghezza del buffer meno index
è minore di count
.
Il valore del parametro buffer
è null
.
index
o count
è negativo.
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
Questo metodo scriverà count
i caratteri dei 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 compreso tra buffer
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)
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(String, Object[])
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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);
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 in formato composito.
- arg
- Object[]
Matrice di oggetti che contiene zero o più oggetti da formattare e scrivere.
Eccezioni
format
o arg
è null
.
TextWriter è chiuso.
Si è verificato un errore di I/O.
format
non è una stringa di formato composto valido.
-oppure-
L'indice di un elemento di formato è minore di zero oppure 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 data e ora standard e stringhe di formato 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 i singoli elementi. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere Formattazione composita.
Elemento | Descrizione |
---|---|
index | 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 parentesi graffe iniziali o finali, 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 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(String, Object)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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);
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 in formato composito.
- arg0
- Object
Oggetto da formattare e scrivere.
Eccezioni
format
è null
.
TextWriter è chiuso.
Si è verificato un errore di I/O.
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).
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 data e ora standard e stringhe di formato 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 i singoli elementi. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere Formattazione composita.
Elemento | Descrizione |
---|---|
index | 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 un solo oggetto nell'elenco di 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 parentesi graffe iniziali o finali, 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 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(UInt64)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Importante
Questa API non è conforme a CLS.
Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte senza segno.
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 a 8 byte senza segno da scrivere.
- Attributi
Eccezioni
TextWriter è chiuso.
Si è verificato 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(UInt32)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Importante
Questa API non è conforme a CLS.
Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte senza segno.
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 a 4 byte senza segno da scrivere.
- Attributi
Eccezioni
TextWriter è chiuso.
Si è verificato 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(StringBuilder)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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 un 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.
Si applica a
Write(String)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive una stringa nel flusso di testo.
public:
virtual void Write(System::String ^ value);
public virtual void Write (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
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
Questo overload equivale all'overload Write(Char[]) .
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 value
è null
, nel flusso di testo non viene scritto alcun dato.
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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Single)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 4 byte.
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
TextWriter è chiuso.
Si è verificato 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(String, Object, Object)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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);
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 in formato composito.
- arg0
- Object
Primo oggetto da formattare e scrivere.
- arg1
- Object
Secondo oggetto da formattare e scrivere.
Eccezioni
format
è null
.
TextWriter è chiuso.
Si è verificato un errore di I/O.
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, è 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 data e ora standard e stringhe di formato 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 i singoli elementi. Per altre informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere Formattazione composita.
Elemento | Descrizione |
---|---|
index | 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 due oggetti nell'elenco di parametri, il valore dell'indice 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 parentesi graffe iniziali o finali, 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 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Object)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo ToString
su tale oggetto.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (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
TextWriter è chiuso.
Si è verificato 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 di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Int64)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte con segno.
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 a 8 byte con segno da scrivere.
Eccezioni
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
La rappresentazione di testo del valore specificato viene prodotta chiamando il Int64.ToString metodo . La TextWriter.FormatProvider proprietà, se non null
, specifica la formattazione specifica delle impostazioni cultura.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Procedura: Scrivere testo in un file
Vedi anche
Si applica a
Write(Int32)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte con segno.
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 a 4 byte con segno da scrivere.
Eccezioni
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
La rappresentazione di testo del valore specificato viene prodotta chiamando il Int32.ToString metodo . La TextWriter.FormatProvider proprietà, se non null
, specifica la formattazione specifica delle impostazioni cultura.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- StreamWriter
- StringWriter
- IFormatProvider
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Double)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 8 byte.
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
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
La rappresentazione di testo del valore specificato viene prodotta chiamando il Double.ToString metodo . La TextWriter.FormatProvider proprietà, se non null
, specifica la formattazione specifica delle impostazioni cultura.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- StreamWriter
- StringWriter
- IFormatProvider
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Decimal)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive nel flusso di testo la rappresentazione testuale di un valore decimale.
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
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
La FormatProvider proprietà, se non null
, specifica la formattazione specifica delle impostazioni cultura.
Vedi anche
- StreamWriter
- StringWriter
- IFormatProvider
- File e Stream I/O
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Char[])
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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);
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
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti 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 di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Write(Char[])
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Char)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Scrive un carattere nel flusso di testo.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
Parametri
- value
- Char
Carattere da scrivere nel flusso di testo.
Eccezioni
TextWriter è chiuso.
Si è verificato 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 la funzionalità appropriata.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Write(Char)
- Write(Char)
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(Boolean)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
Inserisce 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
TextWriter è chiuso.
Si è verificato un errore di I/O.
Commenti
La rappresentazione di testo del valore specificato viene prodotta chiamando il Boolean.ToString metodo .
Questo metodo restituisce Boolean.TrueString o Boolean.FalseString.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- StreamWriter
- StringWriter
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Write(ReadOnlySpan<Char>)
- Origine:
- TextWriter.cs
- Origine:
- TextWriter.cs
- 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 di testo del valore specificato viene prodotta chiamando ReadOnlySpan<Char>. Metodo ToString .
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per