TextWriter.WriteLine Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt Daten, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
Überlädt
WriteLine(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode. |
WriteLine(Char[], Int32, Int32) |
Schreibt ein Unterarray von Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream. |
WriteLine(String, ReadOnlySpan<Object>) | |
WriteLine(String, Object[]) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie Format(String, Object). |
WriteLine(String, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode. |
WriteLine(UInt64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(String, Object, Object, Object) |
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie Format(String, Object). |
WriteLine(UInt32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(StringBuilder) |
Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream. |
WriteLine(String) |
Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Single) |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Double) |
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Object) |
Schreibt durch Aufrufen der |
WriteLine(Int64) |
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Int32) |
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Decimal) |
Schreibt die Textdarstellung eines Dezimalwerts, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream. |
WriteLine(Char[]) |
Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream. |
WriteLine(Char) |
Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream. |
WriteLine(Boolean) |
Schreibt die Textdarstellung eines |
WriteLine() |
Schreibt ein Zeichen für den Zeilenabschluss in den Textstream. |
WriteLine(ReadOnlySpan<Char>) |
Schreibt die Textdarstellung einer Zeichenspanne, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream. |
WriteLine(String, Object, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, 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 kombinierte Formatzeichenfolge.
- arg0
- Object
Das erste zu formatierende und zu schreibende Objekt.
- arg1
- Object
Das zweite zu formatierende und zu schreibende Objekt.
Ausnahmen
format
ist null
.
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
format
ist keine gültige kombinierte Formatzeichenfolge.
- oder -
Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (2 für diese Methodenüberladung).
Hinweise
Diese Methode verwendet die zusammengesetzte Formatierung, um den Wert eines Objekts in seine 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 zur zusammengesetzten Formatierungsfunktion finden Sie unter Zusammengesetzte Formatierung.
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standardformatzeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit.
Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Der format
Parameter besteht aus 0 oder mehr Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, gemischt 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[,length][:formatString]}
Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zur zusammengesetzten Formatierungsfunktion, 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 Objekt ist null , wird das Formatelement durch String.Emptyersetzt. Da diese Überladung zwei Objekte in der Parameterliste enthält, muss der Wert von Index immer 0 oder 1 sein. Wenn an der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
, länge | Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn der Parameter positiv ist, ist er 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 sind identisch mit den Werten, die von der -Methode des ToString(string format) Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable -Schnittstelle implementiert, wird als Wert des Parameters übergeben, null der format IFormattable.ToString als Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden Klammerzeichen "{" und "}" sind erforderlich. Um ein einzelnes literales geschweiftes Klammerzeichen in format
anzugeben, geben Sie zwei führende oder nachfolgende Klammerzeichen an, d. h. "{" oder "}}".
Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenumbruchzeichen (hexadezimale 0x000a) und ersetzt sie durch NewLine.
Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Char[], Int32, Int32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Unterarray von Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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 die Daten gelesen werden.
- index
- Int32
Die Zeichenposition im buffer
, an der mit dem Lesen von Daten begonnen werden soll.
- count
- Int32
Die maximale Anzahl der zu schreibenden Zeichen.
Ausnahmen
Die Pufferlänge minus index
ist kleiner als count
.
Der buffer
-Parameter ist null
.
index
oder count
ist ein negativer Wert.
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Methode schreibt count
Zeichen von Daten aus dem buffer
Zeichenarray ab Position index
in dieseTextWriter
.
Diese Überladung entspricht dem Aufrufen der Write(Char[]) Methode gefolgt von WriteLine für jedes Zeichen buffer
zwischen index
und ( + index
count
).
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(String, ReadOnlySpan<Object>)
public:
virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void WriteLine (string format, scoped ReadOnlySpan<object?> arg);
abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))
Parameter
- format
- String
- arg
- ReadOnlySpan<Object>
Gilt für:
WriteLine(String, Object[])
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params 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 kombinierte Formatzeichenfolge.
- arg
- Object[]
Ein Objektarray mit 0 (null) oder mehr zu formatierenden und zu schreibenden Objekten.
Ausnahmen
Eine Zeichenfolge oder ein Objekt wird als null
übergeben.
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
format
ist keine gültige kombinierte 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 seine Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfangreiche 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 Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
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 Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, vermischt 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[,length][:formatString]}
Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zum Zusammengesetzten Formatierungsfeature, 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 Objekt ist, wird null das Formatelement durch String.Emptyersetzt. Da diese Überladung ein Array in der Parameterliste enthält, muss der Wert des Index immer kleiner als die Länge des Arrays sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
, Länge | Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig. |
:formatString | Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des ToString(string format) Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, null der format IFormattable.ToString als Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden Klammernzeichen "{" und "}" sind erforderlich. Um eine einzelne Literalklammer in format
anzugeben, geben Sie zwei führende oder nachfolgende Klammernzeichen an, d. h. "{{" oder "}}".
Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch NewLine.
Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(String, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, 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 kombinierte Formatzeichenfolge.
- arg0
- Object
Das zu formatierende und zu schreibende Objekt.
Ausnahmen
format
ist null
.
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
format
ist keine gültige kombinierte Formatzeichenfolge.
- oder -
Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (1 für diese Methodenüberladung).
Hinweise
Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in seine Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfangreiche 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 Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
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 Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, vermischt 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[,length][:formatString]}
Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zum Zusammengesetzten Formatierungsfeature, 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 Objekt ist, wird null das Formatelement durch String.Emptyersetzt. Da diese Überladung nur ein einzelnes Objekt in der Parameterliste enthält, muss der Wert von index immer 0 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
, Länge | Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig. |
:formatString | Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des ToString(string format) Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, null der format IFormattable.ToString als Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden Klammernzeichen "{" und "}" sind erforderlich. Um eine einzelne Literalklammer in format
anzugeben, geben Sie zwei führende oder nachfolgende Klammernzeichen an, d. h. "{{" oder "}}".
Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch NewLine.
Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(UInt64)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Wichtig
Diese API ist nicht CLS-kompatibel.
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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 zu schreibende 8-Byte-Ganzzahl ohne Vorzeichen.
- Attribute
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString -Methode erzeugt. Falls FormatProvider nicht null
, gibt die Eigenschaft die kulturspezifische Formatierung an.
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(String, Object, Object, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine formatierte Zeichenfolge und eine neue Zeile in den Textstream unter Verwendung der gleichen Semantik wie 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);
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 kombinierte Formatzeichenfolge.
- arg0
- Object
Das erste zu formatierende und zu schreibende Objekt.
- arg1
- Object
Das zweite zu formatierende und zu schreibende Objekt.
- arg2
- Object
Das dritte zu formatierende und zu schreibende Objekt.
Ausnahmen
format
ist null
.
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
format
ist keine gültige kombinierte Formatzeichenfolge.
- oder -
Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (3 für diese Methodenüberladung).
Hinweise
Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in seine Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfangreiche 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 Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
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 Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, vermischt 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[,length][:formatString]}
Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zum Zusammengesetzten Formatierungsfeature, 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 Objekt ist, wird null das Formatelement durch String.Emptyersetzt. Da diese Überladung drei Objekte in der Parameterliste enthält, muss der Wert von Index immer 0, 1 oder 2 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
, Länge | Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig. |
:formatString | Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des ToString(string format) Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, null der format IFormattable.ToString als Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden Klammernzeichen "{" und "}" sind erforderlich. Um eine einzelne Literalklammer in format
anzugeben, geben Sie zwei führende oder nachfolgende Klammernzeichen an, d. h. "{{" oder "}}".
Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch NewLine.
Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(UInt32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Wichtig
Diese API ist nicht CLS-kompatibel.
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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 zu schreibende 4-Byte-Ganzzahl ohne Vorzeichen.
- Attribute
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString -Methode erzeugt. Falls FormatProvider nicht null
, gibt die Eigenschaft die kulturspezifische Formatierung an.
Der Zeilenabschluss wird durch das CoreNewLine Feld 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(StringBuilder)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung eines Zeichenfolgengenerators, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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, die als Zeichenfolgengenerator in den Textstream geschrieben werden soll.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der StringBuilder.ToString -Methode erzeugt.
Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Gilt für:
WriteLine(String)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
public:
virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (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 value
null
ist, wird nur das Zeichen für den Zeilenabschluss geschrieben.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Überladung entspricht der Write(Char[]) Überladung.
Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.
Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 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: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Single)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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 4-Byte-Gleitkommawert.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Falls FormatProvider nicht null
, gibt die Eigenschaft die kulturspezifische Formatierung an. Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Der Zeilenabschluss wird durch das CoreNewLine Feld definiert.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Double)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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 8-Byte-Gleitkommawert.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Wenn FormatProvider nicht null
, gibt die -Eigenschaft die kulturspezifische Formatierung an. Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt durch Aufrufen der ToString
-Methode für ein Objekt die Textdarstellung dieses Objekts, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
public:
virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (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 value
null
ist, wird nur das Zeichen für den Zeilenabschluss geschrieben.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Überladung entspricht der Write(String, Object) Überladung. Wenn FormatProvider nicht null
, gibt die -Eigenschaft die kulturspezifische Formatierung an.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Int64)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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
Die zu schreibende 8-Byte-Ganzzahl mit Vorzeichen.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int64.ToString -Methode erzeugt. Wenn TextWriter.FormatProvider nicht null
, gibt die -Eigenschaft die kulturspezifische Formatierung an.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Int32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
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 zu schreibende 4-Byte-Ganzzahl mit Vorzeichen.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int32.ToString -Methode erzeugt. Wenn TextWriter.FormatProvider nicht null
, gibt die -Eigenschaft die kulturspezifische Formatierung an.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Decimal)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung eines Dezimalwerts, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Wenn FormatProvider nicht null
, gibt die -Eigenschaft die kulturspezifische Formatierung an. Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Char[])
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Array von Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, in den Textstream.
public:
virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (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 die Daten gelesen werden.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Alle Zeichen in werden in buffer
den zugrunde liegenden Stream geschrieben. Wenn das Zeichenarray null
ist, wird nur das Zeichen für den Zeilenabschluss geschrieben.
Diese Überladung entspricht gefolgt Write(Char[]) von WriteLine() .
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Char)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Zeichen, auf das ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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 in den Textstream zu schreibende Zeichen.
Ausnahmen
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Überladung entspricht gefolgt Write(Char) von WriteLine() .
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(Boolean)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung eines Boolean
-Werts, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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
Der TextWriter ist geschlossen.
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.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine()
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt ein Zeichen für den Zeilenabschluss 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
Der TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
WriteLine(ReadOnlySpan<Char>)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
Schreibt die Textdarstellung einer Zeichenspanne, auf die ein Zeichen für den Zeilenabschluss folgt, in den Textstream.
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 Zeichenspannenwert, der in den Textstream geschrieben werden soll.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen des ReadOnlySpan-Char<> erzeugt. ToString-Methode.
Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.
Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für