TextWriter.WriteLine TextWriter.WriteLine TextWriter.WriteLine TextWriter.WriteLine Method

Definizione

Scrive dati nel flusso di testo, seguiti da un terminatore di riga.Writes data to the text stream, followed by a line terminator.

Overload

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

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

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

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

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

Scrive la rappresentazione testuale di un intero a 8 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

Scrive la rappresentazione testuale di un intero a 4 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

Scrive nel flusso di testo la rappresentazione testuale di un generatore di stringhe, seguita da un terminatore di riga.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Scrive una stringa nel flusso di testo, seguita da un terminatore di riga.Writes a string to the text stream, followed by a line terminator.

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Scrive la rappresentazione testuale di un oggetto nel flusso di testo, chiamando il metodo ToString sull'oggetto, seguita da un terminatore di riga.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

Scrive la rappresentazione testuale di un intero a 8 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

Scrive la rappresentazione testuale di un intero a 4 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Scrive una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Scrive un carattere nel flusso di testo, seguito da un terminatore di riga.Writes a character to the text stream, followed by a line terminator.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Scrivere la rappresentazione testuale di un valore Boolean nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine() WriteLine() WriteLine() WriteLine()

Scrive un terminatore di riga nel flusso di testo.Writes a line terminator to the text stream.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

Scrive nel flusso di testo la rappresentazione testuale di un intervallo di caratteri, seguita da un terminatore di riga.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (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.

-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 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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes a subarray of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

Parametri

buffer
Char[]

Matrice di caratteri da cui vengono letti i dati.The character array from which data is read.

index
Int32 Int32 Int32 Int32

Posizione del carattere in buffer dalla quale avviare la lettura dei dati.The character position in buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

Numero massimo di caratteri da scrivere.The maximum 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 equivale a Write(Char[]) chiamare il metodo seguito da WriteLine per ogni carattere buffer compreso tra index e (index + count).This overload is equivalent to calling the Write(Char[]) method followed by WriteLine for each character in buffer between index and (index + count).

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (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

Viene passato un oggetto o una stringa come null.A string or object is passed in as null.

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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

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

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (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 NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

Importante

Questa API non è conforme a CLS.

Scrive la rappresentazione testuale di un intero a 8 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (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 FormatProvider proprietà, in caso nullcontrario, specifica la formattazione specifica delle impostazioni cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

Importante

Questa API non è conforme a CLS.

Scrive la rappresentazione testuale di un intero a 4 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (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 FormatProvider proprietà, in caso nullcontrario, specifica la formattazione specifica delle impostazioni cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (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.

-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 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 "}}".

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.

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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

Scrive nel flusso di testo la rappresentazione testuale di un generatore di stringhe, seguita da un terminatore di riga.Writes the text representation of a string builder to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (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

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

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Scrive una stringa nel flusso di testo, seguita da un terminatore di riga.Writes a string to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)

Parametri

value
String String String String

Stringa da scrivere.The string to write. Se il parametro value è null, verrà scritto solo il terminatore di riga.If value is null, only the line terminator is written.

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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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.

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

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (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 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Vedi anche

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (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 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Vedi anche

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Scrive la rappresentazione testuale di un oggetto nel flusso di testo, chiamando il metodo ToString sull'oggetto, seguita da un terminatore di riga.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)

Parametri

value
Object Object Object Object

Oggetto da scrivere.The object to write. Se il parametro value è null, verrà scritto solo il terminatore di riga.If value is null, only the line terminator is written.

Eccezioni

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

Commenti

Questo overload è equivalente all' Write(String, Object) overload.This overload is equivalent to the Write(String, Object) overload. La FormatProvider proprietà, in caso nullcontrario, specifica la formattazione specifica delle impostazioni cultura.The FormatProvider property, if not null, specifies the culture-specific formatting.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

Scrive la rappresentazione testuale di un intero a 8 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

Scrive la rappresentazione testuale di un intero a 4 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (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. 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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

Vedi anche

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Scrive una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes an array of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())

Parametri

buffer
Char[]

Matrice di caratteri da cui vengono letti i dati.The character array from which data is read.

Eccezioni

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

Commenti

Tutti i caratteri in buffer vengono scritti nel flusso sottostante.All the characters in buffer are written to the underlying stream. Se la matrice di caratteri è null, viene scritto solo il terminatore di riga.If the character array is null, only the line terminator is written.

Questo overload è equivalente a Write(Char[]) seguito da WriteLine() .This overload is equivalent to Write(Char[]) followed by WriteLine() .

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Scrive un carattere nel flusso di testo, seguito da un terminatore di riga.Writes a character to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (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 overload è equivalente a Write(Char) seguito da WriteLine() .This overload is equivalent to Write(Char) followed by WriteLine() .

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Scrivere la rappresentazione testuale di un valore Boolean nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine() WriteLine() WriteLine() WriteLine()

Scrive un terminatore di riga nel flusso di testo.Writes a line terminator to the text stream.

public:
 virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()

Eccezioni

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

Commenti

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

Scrive nel flusso di testo la rappresentazione testuale di un intervallo di caratteri, seguita da un terminatore di riga.Writes the text representation of a character span to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

Parametri

buffer
ReadOnlySpan<Char>

Valore dell'intervallo di caratteri da scrivere nel flusso di testo.The char span value to write to the text stream.

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.

Il terminatore di riga è definito dal campo CoreNewLine.The line terminator is defined by the CoreNewLine field.

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