Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

TextWriter.WriteLine-Methode (String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge und eine neue Zeile unter Verwendung der gleichen Semantik wie bei Format.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

public virtual void WriteLine(
	string format,
	Object arg0,
	Object arg1,
	Object arg2
)

Parameter

format
Typ: System.String
Eine kombinierte Formatierungszeichenfolge (siehe Hinweise).
arg0
Typ: System.Object
Das erste zu formatierende und zu schreibende Objekt.
arg1
Typ: System.Object
Das zweite zu formatierende und zu schreibende Objekt.
arg2
Typ: System.Object
Das dritte zu formatierende und zu schreibende Objekt.

AusnahmeBedingung
ArgumentNullException

format ist null.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

E/A-Fehler.

FormatException

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

Diese Methode verwendet das Feature für kombinierte Formatierung von .NET Framework, um den Wert eines Objekts in dessen Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET Framework bietet eine umfassende Unterstützung von Formatierungen, die in den folgenden Themen zur Formatierung ausführlicher beschrieben werden.

Der format-Parameter besteht aus 0 (null) oder mehr Textabschnitten, die 0 (null) oder mehr indizierte Platzhalter enthalten, den so genannten Formatelementen, die jeweils einem Objekt in der Parameterliste dieser Methode entsprechen. Im Formatierungsvorgang wird jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts ersetzt.

Die Syntax eines Formatelements sieht folgendermaßen aus:

{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben. Weitere Informationen zur Funktion für die kombinierte Formatierung, einschließlich der Syntax eines Formatelements, finden Sie unter Kombinierte Formatierung.

Element

Beschreibung

Index

Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch index angegebene Objekt null ist, wird das Formatelement durch String.Empty ersetzt. Da diese Überladung drei Objekte in die Parameterliste hat, muss der Wert von Index 0, 1 oder 2. immer sein. Wenn kein Parameter an der index-Position vorhanden ist, wird eine FormatException ausgelöst.

,length

Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Falls positiv, ist der Parameter rechtsbündig, falls negativ, ist er linksbündig.

:formatString

Eine standardmäßige oder benutzerdefinierte Formatzeichenfolge, die vom Objekt unterstützt wird, das formatiert werden soll. Mögliche Werte für formatString entsprechen den Werten, die durch die ToString(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 öffnende und die schließende geschweifte Klammer "{" und "}" sind erforderlich. Um eine einzelne geschweifte Klammer in format als Literalzeichen anzugeben, verwenden Sie zwei vorangestellte oder nachgestellte geschweifte Klammern, also "{{" oder "}}".

Diese Methode sucht nicht die angegebene Zeichenfolge auf einzelne Zeilenumbruchzeichen (hexadezimal) 0x000a und ersetzt sie durch NewLine.

Wenn auf ein angegebenes Objekt nicht in der Formatierungszeichenfolge verwiesen wird, wird dieses ignoriert.

Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.

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

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft