TextWriter.Write Metodo

Definizione

Scrive i dati in un flusso di testo.Writes data to a text stream.

Overload

Write(String, Object, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo.Writes a subarray of characters to the text stream.

Write(String, Object[])

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte senza segno.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte senza segno.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

Scrive un generatore di stringhe nel flusso di testo.Writes a string builder to the text stream.

Write(String)

Scrive una stringa nel flusso di testo.Writes a string to the text stream.

Write(Single)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 4 byte.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, Object, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object)

Scrive nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo ToString su tale oggetto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte con segno.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte con segno.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 8 byte.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

Scrive nel flusso di testo la rappresentazione testuale di un valore decimale.Writes the text representation of a decimal value to the text stream.

Write(Char[])

Scrive una matrice di caratteri nel flusso di testo.Writes a character array to the text stream.

Write(Char)

Scrive un carattere nel flusso di testo.Writes a character to the text stream.

Write(Boolean)

Inserisce nel flusso di testo la rappresentazione testuale di un valore Boolean.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

Scrive un intervallo di caratteri nel flusso di testo.Writes a character span to the text stream.

Write(String, Object, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

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 in formato composto.A composite format string.

arg0
Object

Primo oggetto da formattare e scrivere.The first object to format and write.

arg1
Object

Secondo oggetto da formattare e scrivere.The second object to format and write.

Eccezioni

format è null.format is null.

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

format non è una stringa di formato composto valido.format is not a valid composite format string.

-oppure--or- 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).The index of a format item is less than 0 (zero) or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e incorporare tale rappresentazione in una stringa.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET offre un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il format parametro è costituito da zero o più esecuzioni di testo combinate con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco di parametri di questo metodo.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintassi di un elemento di formato è la seguente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi.Elements in square brackets are optional. La tabella seguente descrive i singoli elementi.The following table describes each element. Per ulteriori informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescrizioneDescription
indexindex Posizione in base zero nell'elenco di parametri dell'oggetto da formattare.The zero-based position in the parameter list of the object to be formatted. Se l'oggetto specificato da index è null, l'elemento di formato viene sostituito da String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Poiché nell'elenco dei parametri di questo overload sono presenti due oggetti, il valore di index deve essere sempre 0 o 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Se non è presente alcun parametro nella posizione di Indice , viene generata un'FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,length Numero minimo di caratteri nella rappresentazione di stringa del parametro.The minimum number of characters in the string representation of the parameter. Se positivo, il parametro è allineato a destra; Se negativo, è allineato a sinistra.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Stringa di formato standard o personalizzata supportata dall'oggetto da formattare.A standard or custom format string that is supported by the object to be formatted. I valori possibili per FormatString sono gli stessi dei valori supportati dal metodo di ToString(string format) dell'oggetto.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString non è specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format usato come stringa di formato IFormattable.ToString.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

I caratteri di parentesi graffe iniziali e finali, "{" e "}", sono obbligatori.The leading and trailing brace characters, "{" and "}", are required. Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due parentesi graffe iniziali o finali; ovvero "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se nella stringa di formato non viene fatto riferimento a un oggetto specificato, questo viene ignorato.If a specified object is not referenced in the format string, it is ignored.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo.Writes a subarray of characters to the text stream.

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.The character array to write data from.

index
Int32

Posizione del carattere nel buffer da cui iniziare il recupero dei dati.The character position in the buffer at which to start retrieving data.

count
Int32

Numero di caratteri da scrivere.The number of characters to write.

Eccezioni

La lunghezza del buffer meno index è minore di count.The buffer length minus index is less than count.

Il parametro buffer è null.The buffer parameter is null.

index o count è negativo.index or count is negative.

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Questo metodo scriverà count caratteri di dati in questo TextWriter dalla matrice di caratteri buffer a partire dalla posizione index.This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Questo overload è equivalente all'overload Write(Char[]) per ogni carattere in buffer tra index e (index + count).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(String, Object[])

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

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 in formato composto.A composite format string.

arg
Object[]

Matrice di oggetti che contiene zero o più oggetti da formattare e scrivere.An object array that contains zero or more objects to format and write.

Eccezioni

format o arg è null.format or arg is null.

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

format non è una stringa di formato composto valido.format is not a valid composite format string.

-oppure--or- L'indice di un elemento di formato è minore di zero oppure maggiore o uguale alla lunghezza della matrice arg.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e incorporare tale rappresentazione in una stringa.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET offre un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il format parametro è costituito da zero o più esecuzioni di testo combinate con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco di parametri di questo metodo.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintassi di un elemento di formato è la seguente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi.Elements in square brackets are optional. La tabella seguente descrive i singoli elementi.The following table describes each element. Per ulteriori informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescrizioneDescription
indexindex Posizione in base zero nell'elenco di parametri dell'oggetto da formattare.The zero-based position in the parameter list of the object to be formatted. Se l'oggetto specificato da index è null, l'elemento di formato viene sostituito da String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Poiché nell'elenco dei parametri di questo overload è presente una matrice, il valore di index deve essere sempre minore della lunghezza della matrice.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Se non è presente alcun parametro nella posizione di Indice , viene generata un'FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,length Numero minimo di caratteri nella rappresentazione di stringa del parametro.The minimum number of characters in the string representation of the parameter. Se positivo, il parametro è allineato a destra; Se negativo, è allineato a sinistra.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Stringa di formato standard o personalizzata supportata dall'oggetto da formattare.A standard or custom format string that is supported by the object to be formatted. I valori possibili per FormatString sono gli stessi dei valori supportati dal metodo di ToString(string format) dell'oggetto.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString non è specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format usato come stringa di formato IFormattable.ToString.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

I caratteri di parentesi graffe iniziali e finali, "{" e "}", sono obbligatori.The leading and trailing brace characters, "{" and "}", are required. Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due parentesi graffe iniziali o finali; ovvero "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se nella stringa di formato non viene fatto riferimento a un oggetto specificato, questo viene ignorato.If a specified object is not referenced in the format string, it is ignored.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(String, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

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 in formato composto.A composite format string.

arg0
Object

Oggetto da formattare e scrivere.The object to format and write.

Eccezioni

format è null.format is null.

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

format non è una stringa di formato composto valido.format is not a valid composite format string.

-oppure--or- 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).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e incorporare tale rappresentazione in una stringa.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET offre un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il format parametro è costituito da zero o più esecuzioni di testo combinate con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco di parametri di questo metodo.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintassi di un elemento di formato è la seguente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi.Elements in square brackets are optional. La tabella seguente descrive i singoli elementi.The following table describes each element. Per ulteriori informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescrizioneDescription
indexindex Posizione in base zero nell'elenco di parametri dell'oggetto da formattare.The zero-based position in the parameter list of the object to be formatted. Se l'oggetto specificato da index è null, l'elemento di formato viene sostituito da String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Poiché questo overload include un solo oggetto nell'elenco di parametri, il valore di index deve essere sempre 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Se non è presente alcun parametro nella posizione di Indice , viene generata un'FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,length Numero minimo di caratteri nella rappresentazione di stringa del parametro.The minimum number of characters in the string representation of the parameter. Se positivo, il parametro è allineato a destra; Se negativo, è allineato a sinistra.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Stringa di formato standard o personalizzata supportata dall'oggetto da formattare.A standard or custom format string that is supported by the object to be formatted. I valori possibili per FormatString sono gli stessi dei valori supportati dal metodo di ToString(string format) dell'oggetto.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString non è specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format usato come stringa di formato IFormattable.ToString.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

I caratteri di parentesi graffe iniziali e finali, "{" e "}", sono obbligatori.The leading and trailing brace characters, "{" and "}", are required. Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due parentesi graffe iniziali o finali; ovvero "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

.. Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se nella stringa di formato non viene fatto riferimento a un oggetto specificato, questo viene ignorato.If a specified object is not referenced in the format string, it is ignored.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(UInt64)

Importante

Questa API non è conforme a CLS.

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte senza segno.Writes the text representation of an 8-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
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.The 8-byte unsigned integer to write.

Attributi

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo UInt64.ToString.The text representation of the specified value is produced by calling the UInt64.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(UInt32)

Importante

Questa API non è conforme a CLS.

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte senza segno.Writes the text representation of a 4-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
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.The 4-byte unsigned integer to write.

Attributi

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo UInt32.ToString.The text representation of the specified value is produced by calling the UInt32.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(StringBuilder)

Scrive un generatore di stringhe nel flusso di testo.Writes a string builder to the text stream.

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.The string, as a string builder, to write to the text stream.

Commenti

Questo metodo equivale a Write(stringBuilder.ToString()), ma usa il metodo StringBuilder.GetChunks per evitare di creare la stringa intermedia.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Write(String)

Scrive una stringa nel flusso di testo.Writes a string to the text stream.

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.The string to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Questo overload è equivalente all'overload Write(Char[]).This overload is equivalent to the Write(Char[]) overload.

Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se value è null, nel flusso di testo non viene scritto alcun dato.If value is null, nothing is written to the text stream.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Single)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 4 byte.Writes the text representation of a 4-byte floating-point value to the text stream.

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.The 4-byte floating-point value to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Single.ToString.The text representation of the specified value is produced by calling the Single.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(String, Object, Object, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

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 in formato composto.A composite format string.

arg0
Object

Primo oggetto da formattare e scrivere.The first object to format and write.

arg1
Object

Secondo oggetto da formattare e scrivere.The second object to format and write.

arg2
Object

Terzo oggetto da formattare e scrivere.The third object to format and write.

Eccezioni

format è null.format is null.

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

format non è una stringa di formato composto valido.format is not a valid composite format string.

-oppure--or- 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).The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

Commenti

Questo metodo usa la formattazione composita per convertire il valore di un oggetto nella relativa rappresentazione di stringa e incorporare tale rappresentazione in una stringa.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET offre un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il format parametro è costituito da zero o più esecuzioni di testo combinate con zero o più segnaposto indicizzati, denominati elementi di formato, che corrispondono a un oggetto nell'elenco di parametri di questo metodo.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. Il processo di formattazione sostituisce ogni elemento di formato con la rappresentazione di stringa del valore dell'oggetto corrispondente.The formatting process replaces each format item with the string representation of the value of the corresponding object.

La sintassi di un elemento di formato è la seguente:The syntax of a format item is as follows:

{index[,length] [:FormatString]}{index[,length][:formatString]}

Gli elementi tra parentesi quadre sono facoltativi.Elements in square brackets are optional. La tabella seguente descrive i singoli elementi.The following table describes each element. Per ulteriori informazioni sulla funzionalità di formattazione composita, inclusa la sintassi di un elemento di formato, vedere formattazione composita.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementoElement DescrizioneDescription
indexindex Posizione in base zero nell'elenco di parametri dell'oggetto da formattare.The zero-based position in the parameter list of the object to be formatted. Se l'oggetto specificato da index è null, l'elemento di formato viene sostituito da String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Poiché nell'elenco dei parametri di questo overload sono presenti tre oggetti, il valore di index deve essere sempre 0, 1 o 2.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Se non è presente alcun parametro nella posizione di Indice , viene generata un'FormatException.If there is no parameter in the index position, a FormatException is thrown.
,length,length Numero minimo di caratteri nella rappresentazione di stringa del parametro.The minimum number of characters in the string representation of the parameter. Se positivo, il parametro è allineato a destra; Se negativo, è allineato a sinistra.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Stringa di formato standard o personalizzata supportata dall'oggetto da formattare.A standard or custom format string that is supported by the object to be formatted. I valori possibili per FormatString sono gli stessi dei valori supportati dal metodo di ToString(string format) dell'oggetto.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Se FormatString non è specificato e l'oggetto da formattare implementa l'interfaccia IFormattable, null viene passato come valore del parametro format usato come stringa di formato IFormattable.ToString.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

I caratteri di parentesi graffe iniziali e finali, "{" e "}", sono obbligatori.The leading and trailing brace characters, "{" and "}", are required. Per specificare un singolo carattere di parentesi graffa letterale in format, specificare due parentesi graffe iniziali o finali; ovvero "{{" o "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Questo metodo non esegue la ricerca della stringa specificata per i singoli caratteri di nuova riga (0x000a esadecimale) e li sostituisce con TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Se nella stringa di formato non viene fatto riferimento a un oggetto specificato, questo viene ignorato.If a specified object is not referenced in the format string, it is ignored.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Object)

Scrive nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo ToString su tale oggetto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

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.The object to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Questo overload è equivalente all'overload Write(String).This overload is equivalent to the Write(String) overload.

Se l'oggetto specificato è null, non viene eseguita alcuna azione e non viene generata alcuna eccezione.If the specified object is null, no action is taken and no exception is thrown. In caso contrario, viene chiamato il metodo di ToString dell'oggetto per produrre la rappresentazione di stringa e la stringa risultante viene quindi scritta nel flusso di output.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. La proprietà FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Int64)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte con segno.Writes the text representation of an 8-byte signed integer to the text stream.

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.The 8-byte signed integer to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Int64.ToString.The text representation of the specified value is produced by calling the Int64.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Procedura: Scrivere un testo in un fileHow to: Write Text to a File

Vedi anche

Write(Int32)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte con segno.Writes the text representation of a 4-byte signed integer to the text stream.

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.The 4-byte signed integer to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Int32.ToString.The text representation of the specified value is produced by calling the Int32.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Double)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 8 byte.Writes the text representation of an 8-byte floating-point value to the text stream.

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.The 8-byte floating-point value to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Double.ToString.The text representation of the specified value is produced by calling the Double.ToString method. La proprietà TextWriter.FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Decimal)

Scrive nel flusso di testo la rappresentazione testuale di un valore decimale.Writes the text representation of a decimal value to the text stream.

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.The decimal value to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La proprietà FormatProvider, se non null, specifica la formattazione specifica delle impostazioni cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Vedi anche

Write(Char[])

Scrive una matrice di caratteri nel flusso di testo.Writes a character array to the text stream.

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.The character array to write to the text stream.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Tramite questo metodo non vengono cercati nella stringa specificata i singoli caratteri di nuova riga (esadecimale 0x000a) e non vengono sostituiti con NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Questo metodo predefinito chiama il metodo Write(Char[], Int32, Int32) e passa l'intera matrice di caratteri.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Se la matrice di caratteri è null, non viene scritto alcun elemento.If the character array is null, nothing is written.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Char)

Scrive un carattere nel flusso di testo.Writes a character to the text stream.

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.The character to write to the text stream.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Questo metodo predefinito non esegue alcuna operazione, ma le classi derivate possono eseguire l'override del metodo per fornire la funzionalità appropriata.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(Boolean)

Inserisce nel flusso di testo la rappresentazione testuale di un valore Boolean.Writes the text representation of a Boolean value to the text stream.

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.The Boolean value to write.

Eccezioni

TextWriter è chiuso.The TextWriter is closed.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il metodo Boolean.ToString.The text representation of the specified value is produced by calling the Boolean.ToString method.

Questo metodo restituisce Boolean.TrueString o Boolean.FalseString.This method outputs either Boolean.TrueString or Boolean.FalseString.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Vedi anche

Write(ReadOnlySpan<Char>)

Scrive un intervallo di caratteri nel flusso di testo.Writes a character span to the text stream.

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.The character span to write.

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il ReadOnlySpan. Metodo ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Si applica a