TextWriter.WriteLine Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Schreibt Daten in den Textstream, gefolgt von einem Zeilenterminator.

Überlädt

WriteLine(String, Object, Object)	Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object)-Methode verwendet wird.
WriteLine(Char[], Int32, Int32)	Schreibt eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(String, Object[])	Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird.
WriteLine(String, Object)	Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird.
WriteLine(UInt64)	Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(String, Object, Object, Object)	Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird.
WriteLine(UInt32)	Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(StringBuilder)	Schreibt die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(String)	Schreibt eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Single)	Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Double)	Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Object)	Schreibt die Textdarstellung eines Objekts in den Textstream, indem die ToString-Methode für dieses Objekt aufgerufen wird, gefolgt von einem Zeilenterminator.
WriteLine(Int64)	Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Int32)	Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Decimal)	Schreibt die Textdarstellung eines Dezimalwerts in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Char[])	Schreibt ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Char)	Schreibt ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator.
WriteLine(Boolean)	Schreibt die Textdarstellung eines Boolean Werts in den Textstream, gefolgt von einem Zeilenbeschriftungszeichen.
WriteLine()	Schreibt einen Zeilenendpunkt in den Textstream.
WriteLine(ReadOnlySpan<Char>)	Schreibt die Textdarstellung eines Zeichenbereichs in den Textstream, gefolgt von einem Zeilenterminator.

WriteLine(String, Object, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object)-Methode verwendet wird.

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)

Parameter

format

String

Eine zusammengesetzte Formatzeichenfolge.

arg0

Object

Das erste Objekt, das formatiert und geschrieben werden soll.

arg1

Object

Das zweite Objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich der Anzahl der zu formatierenden Objekte (die bei dieser Methodenüberladung zwei sind).

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

• Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter standard numeric format strings und Custom Numeric Format Strings.

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

• Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.

• Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objektnullist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung zwei Objekte in der Parameterliste enthält, muss der Wert Index immer 0 oder 1 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in formatangeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.

Wenn auf ein angegebenes Objekt in der Formatzeichenfolge nicht verwiesen wird, wird es ignoriert.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Char[], Int32, Int32)

Quelle:

TextWriter.cs

Schreibt eine Unterarray von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

buffer

Char[]

Das Zeichenarray, aus dem Daten gelesen werden.

index

Int32

Die Zeichenposition in buffer, an der mit dem Lesen von Daten begonnen werden soll.

count

Int32

Die maximale Anzahl von Zeichen, die geschrieben werden sollen.

Ausnahmen

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentNullException

Der parameter buffer ist null.

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Methode schreibt count Zeichen von Daten in diese TextWriter aus dem buffer Zeichenarray beginnend an position index.

Diese Überladung entspricht dem Aufrufen der Write(Char[])-Methode, gefolgt von WriteLine für jedes Zeichen in buffer zwischen index und (index + count).

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(String, Object[])

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird.

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

Parameter

format

String

Eine zusammengesetzte Formatzeichenfolge.

arg

Object[]

Ein Objektarray, das null oder mehr Objekte zum Formatieren und Schreiben enthält.

Ausnahmen

ArgumentNullException

Eine Zeichenfolge oder ein Objekt wird als nullübergeben.

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer oder gleich der Länge des arg Arrays.

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

• Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter standard numeric format strings und Custom Numeric Format Strings.

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

• Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.

• Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objektnullist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung ein Array in der Parameterliste enthält, muss der Wert Index immer kleiner als die Länge des Arrays sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in formatangeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.

Wenn auf ein angegebenes Objekt in der Formatzeichenfolge nicht verwiesen wird, wird es ignoriert.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(String, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie die Format(String, Object)-Methode verwendet wird.

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)

Parameter

format

String

Eine zusammengesetzte Formatzeichenfolge.

arg0

Object

Das objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich der Anzahl der zu formatierenden Objekte (die für diese Methodenüberladung eins ist).

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

• Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter standard numeric format strings und Custom Numeric Format Strings.

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

• Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.

• Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objektnullist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung nur ein einzelnes Objekt in der Parameterliste enthält, muss der Wert Index immer 0 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in formatangeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.

Wenn auf ein angegebenes Objekt in der Formatzeichenfolge nicht verwiesen wird, wird es ignoriert.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(UInt64)

Quelle:

TextWriter.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator.

public:
 virtual void WriteLine(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);

[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit

Public Overridable Sub WriteLine (value As ULong)

Parameter

value

UInt64

Die 8-Byte-Ganzzahl ohne Vorzeichen, die geschrieben werden soll.

Attribute

CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString-Methode erzeugt. Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(String, Object, Object, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream, wobei die gleiche Semantik wie Format(String, Object)verwendet wird.

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)

Parameter

format

String

Eine zusammengesetzte Formatzeichenfolge.

arg0

Object

Das erste Objekt, das formatiert und geschrieben werden soll.

arg1

Object

Das zweite Objekt, das formatiert und geschrieben werden soll.

arg2

Object

Das dritte Objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich der Anzahl der zu formatierenden Objekte (die für diese Methodenüberladung drei sind).

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

• Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter standard numeric format strings und Custom Numeric Format Strings.

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

• Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.

• Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{Index[,Länge][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch Index angegebene Objektnullist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung drei Objekte in der Parameterliste enthält, muss der Wert Index immer 0, 1 oder 2 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
,Länge	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter rechtsbündig ausgerichtet; wenn negativ, wird sie linksbündig ausgerichtet.
:formatString-	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in formatangeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.

Wenn auf ein angegebenes Objekt in der Formatzeichenfolge nicht verwiesen wird, wird es ignoriert.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(UInt32)

Quelle:

TextWriter.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream, gefolgt von einem Zeilenterminator.

public:
 virtual void WriteLine(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);

[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit

Public Overridable Sub WriteLine (value As UInteger)

Parameter

value

UInt32

Die 4-Byte-Ganzzahl ohne Vorzeichen, die geschrieben werden soll.

Attribute

CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString-Methode erzeugt. Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(StringBuilder)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines Zeichenfolgen-Generators in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

StringBuilder

Die Zeichenfolge als Zeichenfolgen-Generator, um in den Textstream zu schreiben.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der StringBuilder.ToString-Methode erzeugt.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

WriteLine(String)

Quelle:

TextWriter.cs

Schreibt eine Zeichenfolge in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

String

Die zu schreibende Zeichenfolge. Wenn valuenullist, wird nur der Zeilenterminator geschrieben.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Überladung entspricht der Write(Char[]) Überladung.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Single)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Single

Der zu schreibende Gleitkommawert von 4 Byte.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Double)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Double

Der zu schreibende Gleitkommawert von 8 Byte.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Object)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines Objekts in den Textstream, indem die ToString-Methode für dieses Objekt aufgerufen wird, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Object

Das zu schreibende Objekt. Wenn valuenullist, wird nur der Zeilenterminator geschrieben.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Überladung entspricht der Write(String, Object) Überladung. Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Int64)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Int64

Der zu schreibende ganzzahlige 8-Byte-Wert.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int64.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Int32)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Int32

Die mit 4 Byte signierte ganze Zahl, die geschrieben werden soll.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int32.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Decimal)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines Dezimalwerts in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Decimal

Der zu schreibende Dezimalwert.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die FormatProvider-Eigenschaft gibt, wenn nicht null, die kulturspezifische Formatierung an. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Char[])

Quelle:

TextWriter.cs

Schreibt ein Array von Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

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

Parameter

buffer

Char[]

Das Zeichenarray, aus dem Daten gelesen werden.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Alle Zeichen in buffer werden in den zugrunde liegenden Datenstrom geschrieben. Wenn das Zeichenarray nullist, wird nur der Zeilenterminator geschrieben.

Diese Überladung entspricht Write(Char[]) gefolgt von WriteLine().

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Char)

Quelle:

TextWriter.cs

Schreibt ein Zeichen in den Textstream, gefolgt von einem Zeilenterminator.

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)

Parameter

value

Char

Das Zeichen, das in den Textstream geschrieben werden soll.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Überladung entspricht Write(Char) gefolgt von WriteLine().

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(Boolean)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines Boolean Werts in den Textstream, gefolgt von einem Zeilenbeschriftungszeichen.

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)

Parameter

value

Boolean

Der zu schreibende Boolean Wert.

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Boolean.ToString-Methode erzeugt.

Diese Methode gibt entweder Boolean.TrueString oder Boolean.FalseStringaus.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine()

Quelle:

TextWriter.cs

Schreibt einen Zeilenendpunkt in den Textstream.

public:
 virtual void WriteLine();

public virtual void WriteLine ();

abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit

Public Overridable Sub WriteLine ()

Ausnahmen

ObjectDisposedException

Die TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A-
• How to: Read Text from a File
• How to: Write Text to a File

WriteLine(ReadOnlySpan<Char>)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung eines Zeichenbereichs in den Textstream, gefolgt von einem Zeilenterminator.

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

Parameter

buffer

ReadOnlySpan<Char>

Der Zeichenspannwert, der in den Textstream geschrieben werden soll.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen des ReadOnlySpan<Char>erzeugt. ToString-Methode.

Der Zeilenendpunkt wird durch das feld CoreNewLine definiert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.