TextWriter.Write TextWriter.Write TextWriter.Write TextWriter.Write Method

Definizione

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

Overload

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) 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) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) 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[]) Write(String, Object[]) Write(String, Object[]) 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) Write(String, Object) Write(String, Object) 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) Write(UInt64) Write(UInt64) 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) Write(UInt32) Write(UInt32) 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) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

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

Write(String) Write(String) Write(String) Write(String)

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

Write(Single) Write(Single) Write(Single) 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) Write(String, Object, Object, Object) Write(String, Object, Object, Object) 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) Write(Object) Write(Object) 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) Write(Int64) Write(Int64) 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) Write(Int32) Write(Int32) 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) Write(Double) Write(Double) 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) Write(Decimal) Write(Decimal) 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[]) Write(Char[]) Write(Char[]) Write(Char[])

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

Write(Char) Write(Char) Write(Char) Write(Char)

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

Write(Boolean) Write(Boolean) Write(Boolean) 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>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

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

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) 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 String String String

Stringa in formato composito.A composite format string.

arg0
Object Object Object Object

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

arg1
Object Object Object Object

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

Eccezioni

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.

In alternativa-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 DescriptionDescription
indiceindex 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 String.Emptyda.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 dell' Indice , FormatException viene generata un'eccezione.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 ToString(string format) metodo 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 IFormattable l'oggetto da formattare implementa l'interfaccia, null format viene passato come valore del parametro usato come IFormattable.ToString stringa di formato.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 caratteri 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) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) 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 Int32 Int32 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 Int32 Int32 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 valore del parametro buffer è null.The buffer parameter is null.

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

Commenti

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

Questo overload è Write(Char[]) equivalente all'overload per ogni buffer carattere compreso 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[]) Write(String, Object[]) Write(String, Object[]) 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 String String String

Stringa in formato composito.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

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 DescriptionDescription
indiceindex 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 String.Emptyda.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 dell' Indice , FormatException viene generata un'eccezione.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 ToString(string format) metodo 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 IFormattable l'oggetto da formattare implementa l'interfaccia, null format viene passato come valore del parametro usato come IFormattable.ToString stringa di formato.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 caratteri 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) Write(String, Object) Write(String, Object) 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 String String String

Stringa in formato composito.A composite format string.

arg0
Object Object Object Object

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

Eccezioni

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 DescriptionDescription
indiceindex 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 String.Emptyda.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 dell' Indice , FormatException viene generata un'eccezione.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 ToString(string format) metodo 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 IFormattable l'oggetto da formattare implementa l'interfaccia, null format viene passato come valore del parametro usato come IFormattable.ToString stringa di formato.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 caratteri 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) Write(UInt64) Write(UInt64) 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 UInt64 UInt64 UInt64

Intero a 8 byte senza segno da scrivere.The 8-byte unsigned integer to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il UInt64.ToString metodo.The text representation of the specified value is produced by calling the UInt64.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(UInt32) Write(UInt32) 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 UInt32 UInt32 UInt32

Intero a 4 byte senza segno da scrivere.The 4-byte unsigned integer to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il UInt32.ToString metodo.The text representation of the specified value is produced by calling the UInt32.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(StringBuilder) Write(StringBuilder) 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 StringBuilder StringBuilder 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 è equivalente a Write(stringBuilder.ToString()), ma usa il StringBuilder.GetChunks metodo 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) Write(String) Write(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 String String String

Stringa da scrivere.The string to write.

Eccezioni

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

Commenti

Questo overload è equivalente all' Write(Char[]) overload.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) Write(Single) Write(Single) 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 Single Single Single

Valore a virgola mobile a 4 byte da scrivere.The 4-byte floating-point value to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Single.ToString metodo.The text representation of the specified value is produced by calling the Single.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(String, Object, Object, Object) Write(String, Object, Object, Object) 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 String String String

Stringa in formato composito.A composite format string.

arg0
Object Object Object Object

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

arg1
Object Object Object Object

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

arg2
Object Object Object Object

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

Eccezioni

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.

In alternativa-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 DescriptionDescription
indiceindex 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 String.Emptyda.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 dell' Indice , FormatException viene generata un'eccezione.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 ToString(string format) metodo 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 IFormattable l'oggetto da formattare implementa l'interfaccia, null format viene passato come valore del parametro usato come IFormattable.ToString stringa di formato.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 caratteri 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 TextWriter.NewLine) e li sostituisce con.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) Write(Object) Write(Object) 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 Object Object Object

Oggetto da scrivere.The object to write.

Eccezioni

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

Commenti

Questo overload è equivalente all' Write(String) overload.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 ToString chiamato il metodo 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 FormatProvider proprietà, in caso nullcontrario, 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) Write(Int64) Write(Int64) 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 Int64 Int64 Int64

Intero a 8 byte con segno da scrivere.The 8-byte signed integer to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Int64.ToString metodo.The text representation of the specified value is produced by calling the Int64.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(Int32) Write(Int32) 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 Int32 Int32 Int32

Intero a 4 byte con segno da scrivere.The 4-byte signed integer to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Int32.ToString metodo.The text representation of the specified value is produced by calling the Int32.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(Double) Write(Double) 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 Double Double Double

Valore a virgola mobile a 8 byte da scrivere.The 8-byte floating-point value to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Double.ToString metodo.The text representation of the specified value is produced by calling the Double.ToString method. La TextWriter.FormatProvider proprietà, in caso nullcontrario, 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) Write(Decimal) Write(Decimal) 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 Decimal Decimal Decimal

Valore decimale da scrivere.The decimal value to write.

Eccezioni

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

Commenti

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

Vedi anche

Write(Char[]) Write(Char[]) Write(Char[]) 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

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 Write(Char[], Int32, Int32) metodo 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) Write(Char) Write(Char) Write(Char)

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

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 Char Char Char

Carattere da scrivere nel flusso di testo.The character to write to the text stream.

Eccezioni

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) Write(Boolean) Write(Boolean) 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 Boolean Boolean Boolean

Valore Boolean da scrivere.The Boolean value to write.

Eccezioni

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

Commenti

La rappresentazione testuale del valore specificato viene generata chiamando il Boolean.ToString metodo.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>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) 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 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