TextWriter.Write Methode

Definition

Schreibt Daten in einen Textstream.Writes data to a text stream.

Überlädt

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen in den Textstream.Writes a subarray of characters to the text stream.

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

Schreibt einen Zeichenfolgengenerator in den Textstream.Writes a string builder to the text stream.

Write(String)

Schreibt eine Zeichenfolge in den Textstream.Writes a string to the text stream.

Write(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object)

Schreibt die Textdarstellung eines Objekts in den Textstream, indem für das Objekt die ToString-Methode aufgerufen wird.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in den Textstream.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in den Textstream.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts in den Textstream.Writes the text representation of a decimal value to the text stream.

Write(Char[])

Schreibt ein Zeichenarray in den Textstream.Writes a character array to the text stream.

Write(Char)

Schreibt ein Zeichen in den Textstream.Writes a character to the text stream.

Write(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts in den Textstream.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Textstream.Writes a character span to the text stream.

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

Parameter

format
String

Eine kombinierte Formatierungszeichenfolge.A composite format string.

arg0
Object

Das erste zu formatierende und zu schreibende Objekt.The first object to format and write.

arg1
Object

Das zweite zu formatierende und zu schreibende Objekt.The second object to format and write.

Ausnahmen

format ist null.format is null.

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

format ist keine gültige kombinierte Formatzeichenfolge.format is not a valid composite format string.

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

Hinweise

Diese Methode verwendet die kombinierte Formatierung, um den Wert eines Objekts in seine Zeichen folgen Darstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten.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 bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der format-Parameter besteht aus null oder mehr Text Läufen mit NULL oder mehr indizierten Platzhaltern, so genannten Format Elementen, die einem Objekt in der Parameterliste dieser Methode entsprechen.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. Der Formatierungsprozess ersetzt jedes Format Element durch die Zeichen folgen Darstellung des Werts des entsprechenden Objekts.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Die Syntax eines Format Elements lautet wie folgt:The syntax of a format item is as follows:

{Index[,length] [:FormatString]}{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional.Elements in square brackets are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element. Weitere Informationen zur Funktion für die kombinierte Formatierung, einschließlich der Syntax eines Format Elements, finden Sie unter kombinierte Formatierung.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement BeschreibungDescription
indexindex Die null basierte Position in der Parameterliste des-Objekts, das formatiert werden soll.The zero-based position in the parameter list of the object to be formatted. Wenn das durch den Index angegebene Objekt nullist, wird das Format Element durch String.Emptyersetzt.If the object specified by index is null, the format item is replaced by String.Empty. Da diese Überladung zwei Objekte in der Parameterliste aufweist, muss der Wert des Indexes immer 0 oder 1 sein.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Wenn an der Index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.If there is no parameter in the index position, a FormatException is thrown.
,length,length Die Mindestanzahl von Zeichen in der Zeichen folgen Darstellung des-Parameters.The minimum number of characters in the string representation of the parameter. Wenn dies positiv ist, wird der-Parameter rechtsbündig ausgerichtet. Wenn der Wert negativ ist, wird er linksbündig ausgerichtet.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:Format Zeichenfolge:formatString Eine standardmäßige oder benutzerdefinierte Format Zeichenfolge, die vom zu formatierenden Objekt unterstützt wird.A standard or custom format string that is supported by the object to be formatted. Mögliche Werte für " FormatString " entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Wenn FormatString nicht angegeben wird und das zu formatierende Objekt die IFormattable-Schnittstelle implementiert, wird null als Wert des format-Parameters übergeben, der als IFormattable.ToString Format Zeichenfolge verwendet wird.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.

Die führenden und nachfolgenden geschweifter Klammern ("{" und "}") sind erforderlich.The leading and trailing brace characters, "{" and "}", are required. Geben Sie zwei führende oder nachfolgende geschweifter Klammer Zeichen an, um ein einzelnes literaltrennzeichen in formatanzugeben. Das heißt, "{{" oder "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Wenn in der Format Zeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.If a specified object is not referenced in the format string, it is ignored.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen in den Textstream.Writes a subarray of characters to the text stream.

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

Parameter

buffer
Char[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.The character array to write data from.

index
Int32

Die Zeichenposition im Puffer, an der mit dem Abrufen von Daten begonnen werden soll.The character position in the buffer at which to start retrieving data.

count
Int32

Die Anzahl der zu schreibenden Zeichen.The number of characters to write.

Ausnahmen

Die Pufferlänge minus index ist kleiner als count.The buffer length minus index is less than count.

Der Parameter buffer ist null.The buffer parameter is null.

index oder count ist ein negativer Wert.index or count is negative.

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Methode schreibt count Zeichen von Daten aus dem buffer Zeichen Array in diese TextWriter, beginnend an der Position index.This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

Diese Überladung entspricht der Write(Char[]) Überladung für jedes Zeichen in buffer zwischen index und (index + count).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable Sub Write (format As String, ParamArray arg As Object())

Parameter

format
String

Eine kombinierte Formatierungszeichenfolge.A composite format string.

arg
Object[]

Ein Objektarray mit 0 (null) oder mehr zu formatierenden und zu schreibenden Objekten.An object array that contains zero or more objects to format and write.

Ausnahmen

format oder arg ist null.format or arg is null.

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

format ist keine gültige kombinierte Formatzeichenfolge.format is not a valid composite format string.

- oder --or- Der Index eines Formatelements ist kleiner als 0 (null) oder größer oder gleich der Länge des arg-Arrays.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

Hinweise

Diese Methode verwendet die kombinierte Formatierung, um den Wert eines Objekts in seine Zeichen folgen Darstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten.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 bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der format-Parameter besteht aus null oder mehr Text Läufen mit NULL oder mehr indizierten Platzhaltern, so genannten Format Elementen, die einem Objekt in der Parameterliste dieser Methode entsprechen.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. Der Formatierungsprozess ersetzt jedes Format Element durch die Zeichen folgen Darstellung des Werts des entsprechenden Objekts.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Die Syntax eines Format Elements lautet wie folgt:The syntax of a format item is as follows:

{Index[,length] [:FormatString]}{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional.Elements in square brackets are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element. Weitere Informationen zur Funktion für die kombinierte Formatierung, einschließlich der Syntax eines Format Elements, finden Sie unter kombinierte Formatierung.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement BeschreibungDescription
indexindex Die null basierte Position in der Parameterliste des-Objekts, das formatiert werden soll.The zero-based position in the parameter list of the object to be formatted. Wenn das durch den Index angegebene Objekt nullist, wird das Format Element durch String.Emptyersetzt.If the object specified by index is null, the format item is replaced by String.Empty. Da diese Überladung über ein Array in der Parameterliste verfügt, muss der Wert des Indexes immer kleiner als die Länge des Arrays sein.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Wenn an der Index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.If there is no parameter in the index position, a FormatException is thrown.
,length,length Die Mindestanzahl von Zeichen in der Zeichen folgen Darstellung des-Parameters.The minimum number of characters in the string representation of the parameter. Wenn dies positiv ist, wird der-Parameter rechtsbündig ausgerichtet. Wenn der Wert negativ ist, wird er linksbündig ausgerichtet.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:Format Zeichenfolge:formatString Eine standardmäßige oder benutzerdefinierte Format Zeichenfolge, die vom zu formatierenden Objekt unterstützt wird.A standard or custom format string that is supported by the object to be formatted. Mögliche Werte für " FormatString " entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Wenn FormatString nicht angegeben wird und das zu formatierende Objekt die IFormattable-Schnittstelle implementiert, wird null als Wert des format-Parameters übergeben, der als IFormattable.ToString Format Zeichenfolge verwendet wird.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.

Die führenden und nachfolgenden geschweifter Klammern ("{" und "}") sind erforderlich.The leading and trailing brace characters, "{" and "}", are required. Geben Sie zwei führende oder nachfolgende geschweifter Klammer Zeichen an, um ein einzelnes literaltrennzeichen in formatanzugeben. Das heißt, "{{" oder "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Wenn in der Format Zeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.If a specified object is not referenced in the format string, it is ignored.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(String, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object)

Parameter

format
String

Eine kombinierte Formatierungszeichenfolge.A composite format string.

arg0
Object

Das zu formatierende und zu schreibende Objekt.The object to format and write.

Ausnahmen

format ist null.format is null.

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

format ist keine gültige kombinierte Formatzeichenfolge.format is not a valid composite format string.

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

Hinweise

Diese Methode verwendet die kombinierte Formatierung, um den Wert eines Objekts in seine Zeichen folgen Darstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten.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 bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der format-Parameter besteht aus null oder mehr Text Läufen mit NULL oder mehr indizierten Platzhaltern, so genannten Format Elementen, die einem Objekt in der Parameterliste dieser Methode entsprechen.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. Der Formatierungsprozess ersetzt jedes Format Element durch die Zeichen folgen Darstellung des Werts des entsprechenden Objekts.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Die Syntax eines Format Elements lautet wie folgt:The syntax of a format item is as follows:

{Index[,length] [:FormatString]}{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional.Elements in square brackets are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element. Weitere Informationen zur Funktion für die kombinierte Formatierung, einschließlich der Syntax eines Format Elements, finden Sie unter kombinierte Formatierung.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement BeschreibungDescription
indexindex Die null basierte Position in der Parameterliste des-Objekts, das formatiert werden soll.The zero-based position in the parameter list of the object to be formatted. Wenn das durch den Index angegebene Objekt nullist, wird das Format Element durch String.Emptyersetzt.If the object specified by index is null, the format item is replaced by String.Empty. Da diese Überladung nur über ein einzelnes Objekt in der Parameterliste verfügt, muss der Wert des Indexes immer 0 sein.Because this overload has only a single object in its parameter list, the value of index must always be 0. Wenn an der Index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.If there is no parameter in the index position, a FormatException is thrown.
,length,length Die Mindestanzahl von Zeichen in der Zeichen folgen Darstellung des-Parameters.The minimum number of characters in the string representation of the parameter. Wenn dies positiv ist, wird der-Parameter rechtsbündig ausgerichtet. Wenn der Wert negativ ist, wird er linksbündig ausgerichtet.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:Format Zeichenfolge:formatString Eine standardmäßige oder benutzerdefinierte Format Zeichenfolge, die vom zu formatierenden Objekt unterstützt wird.A standard or custom format string that is supported by the object to be formatted. Mögliche Werte für " FormatString " entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Wenn FormatString nicht angegeben wird und das zu formatierende Objekt die IFormattable-Schnittstelle implementiert, wird null als Wert des format-Parameters übergeben, der als IFormattable.ToString Format Zeichenfolge verwendet wird.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.

Die führenden und nachfolgenden geschweifter Klammern ("{" und "}") sind erforderlich.The leading and trailing brace characters, "{" and "}", are required. Geben Sie zwei führende oder nachfolgende geschweifter Klammer Zeichen an, um ein einzelnes literaltrennzeichen in formatanzugeben. Das heißt, "{{" oder "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

.. Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Wenn in der Format Zeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.If a specified object is not referenced in the format string, it is ignored.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(UInt64)

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream.Writes the text representation of an 8-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)

Parameter

value
UInt64

Die zu schreibende 8-Byte-Ganzzahl ohne Vorzeichen.The 8-byte unsigned integer to write.

Attribute

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the UInt64.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(UInt32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream.Writes the text representation of a 4-byte unsigned integer to the text stream.

public:
 virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)

Parameter

value
UInt32

Die zu schreibende 4-Byte-Ganzzahl ohne Vorzeichen.The 4-byte unsigned integer to write.

Attribute

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the UInt32.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(StringBuilder)

Schreibt einen Zeichenfolgengenerator in den Textstream.Writes a string builder to the text stream.

public:
 virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)

Parameter

value
StringBuilder

Die Zeichenfolge, die als Zeichenfolgengenerator in den Textstream geschrieben werden soll.The string, as a string builder, to write to the text stream.

Hinweise

Diese Methode entspricht Write(stringBuilder.ToString()), verwendet jedoch die StringBuilder.GetChunks-Methode, um zu vermeiden, dass die zwischen Zeichenfolge erstellt wird.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Write(String)

Schreibt eine Zeichenfolge in den Textstream.Writes a string to the text stream.

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

Parameter

value
String

Die zu schreibende Zeichenfolge.The string to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Überladung entspricht der Write(Char[]) Überladung.This overload is equivalent to the Write(Char[]) overload.

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Wenn value den Wert null hat, wird nichts in den Stream geschrieben.If value is null, nothing is written to the text stream.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream.Writes the text representation of a 4-byte floating-point value to the text stream.

public:
 virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)

Parameter

value
Single

Der zu schreibende 4-Byte-Gleitkommawert.The 4-byte floating-point value to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Single.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the Single.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parameter

format
String

Eine kombinierte Formatierungszeichenfolge.A composite format string.

arg0
Object

Das erste zu formatierende und zu schreibende Objekt.The first object to format and write.

arg1
Object

Das zweite zu formatierende und zu schreibende Objekt.The second object to format and write.

arg2
Object

Das dritte zu formatierende und zu schreibende Objekt.The third object to format and write.

Ausnahmen

format ist null.format is null.

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

format ist keine gültige kombinierte Formatzeichenfolge.format is not a valid composite format string.

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

Hinweise

Diese Methode verwendet die kombinierte Formatierung, um den Wert eines Objekts in seine Zeichen folgen Darstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten.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 bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der format-Parameter besteht aus null oder mehr Text Läufen mit NULL oder mehr indizierten Platzhaltern, so genannten Format Elementen, die einem Objekt in der Parameterliste dieser Methode entsprechen.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. Der Formatierungsprozess ersetzt jedes Format Element durch die Zeichen folgen Darstellung des Werts des entsprechenden Objekts.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Die Syntax eines Format Elements lautet wie folgt:The syntax of a format item is as follows:

{Index[,length] [:FormatString]}{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional.Elements in square brackets are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element. Weitere Informationen zur Funktion für die kombinierte Formatierung, einschließlich der Syntax eines Format Elements, finden Sie unter kombinierte Formatierung.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement BeschreibungDescription
indexindex Die null basierte Position in der Parameterliste des-Objekts, das formatiert werden soll.The zero-based position in the parameter list of the object to be formatted. Wenn das durch den Index angegebene Objekt nullist, wird das Format Element durch String.Emptyersetzt.If the object specified by index is null, the format item is replaced by String.Empty. Da diese Überladung drei Objekte in der Parameterliste aufweist, muss der Wert des Indexes immer 0, 1 oder 2 sein.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Wenn an der Index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst.If there is no parameter in the index position, a FormatException is thrown.
,length,length Die Mindestanzahl von Zeichen in der Zeichen folgen Darstellung des-Parameters.The minimum number of characters in the string representation of the parameter. Wenn dies positiv ist, wird der-Parameter rechtsbündig ausgerichtet. Wenn der Wert negativ ist, wird er linksbündig ausgerichtet.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:Format Zeichenfolge:formatString Eine standardmäßige oder benutzerdefinierte Format Zeichenfolge, die vom zu formatierenden Objekt unterstützt wird.A standard or custom format string that is supported by the object to be formatted. Mögliche Werte für " FormatString " entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Wenn FormatString nicht angegeben wird und das zu formatierende Objekt die IFormattable-Schnittstelle implementiert, wird null als Wert des format-Parameters übergeben, der als IFormattable.ToString Format Zeichenfolge verwendet wird.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.

Die führenden und nachfolgenden geschweifter Klammern ("{" und "}") sind erforderlich.The leading and trailing brace characters, "{" and "}", are required. Geben Sie zwei führende oder nachfolgende geschweifter Klammer Zeichen an, um ein einzelnes literaltrennzeichen in formatanzugeben. Das heißt, "{{" oder "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Wenn in der Format Zeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.If a specified object is not referenced in the format string, it is ignored.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Object)

Schreibt die Textdarstellung eines Objekts in den Textstream, indem für das Objekt die ToString-Methode aufgerufen wird.Writes the text representation of an object to the text stream by calling the ToString method on that object.

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

Parameter

value
Object

Das zu schreibende Objekt.The object to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Überladung entspricht der Write(String) Überladung.This overload is equivalent to the Write(String) overload.

Wenn das angegebene Objekt nullist, wird keine Aktion ausgeführt, und es wird keine Ausnahme ausgelöst.If the specified object is null, no action is taken and no exception is thrown. Andernfalls wird die ToString-Methode des Objekts aufgerufen, um die Zeichen folgen Darstellung zu schaffen, und die resultierende Zeichenfolge wird dann in den Ausgabestream geschrieben.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. Die FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in den Textstream.Writes the text representation of an 8-byte signed integer to the text stream.

public:
 virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)

Parameter

value
Int64

Die zu schreibende 8-Byte-Ganzzahl mit Vorzeichen.The 8-byte signed integer to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int64.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the Int64.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Gewusst wie: Schreiben von Text in eine DateiHow to: Write Text to a File

Siehe auch

Write(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in den Textstream.Writes the text representation of a 4-byte signed integer to the text stream.

public:
 virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)

Parameter

value
Int32

Die zu schreibende 4-Byte-Ganzzahl mit Vorzeichen.The 4-byte signed integer to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int32.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the Int32.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream.Writes the text representation of an 8-byte floating-point value to the text stream.

public:
 virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)

Parameter

value
Double

Der zu schreibende 8-Byte-Gleitkommawert.The 8-byte floating-point value to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Double.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the Double.ToString method. Die TextWriter.FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts in den Textstream.Writes the text representation of a decimal value to the text stream.

public:
 virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)

Parameter

value
Decimal

Der zu schreibende Dezimalwert.The decimal value to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die FormatProvider-Eigenschaft gibt die kulturspezifische Formatierung an, wenn Sie nicht nullwird.The FormatProvider property, if not null, specifies the culture-specific formatting.

Siehe auch

Write(Char[])

Schreibt ein Zeichenarray in den Textstream.Writes a character array to the text stream.

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

Parameter

buffer
Char[]

Das in den Textstream zu schreibende Zeichenarray.The character array to write to the text stream.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenvorschub Zeichen (hexadezimal 0x000a) und ersetzt Sie durch NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Diese Standardmethode Ruft die Write(Char[], Int32, Int32)-Methode auf und übergibt das gesamte Zeichen Array.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Wenn das Zeichen Array nullist, wird nichts geschrieben.If the character array is null, nothing is written.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Char)

Schreibt ein Zeichen in den Textstream.Writes a character to the text stream.

public:
 virtual void Write(char value);
public virtual void Write (char value);
abstract member Write : char -> unit
override this.Write : char -> unit
Public Overridable Sub Write (value As Char)

Parameter

value
Char

Das in den Textstream zu schreibende Zeichen.The character to write to the text stream.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Standardmethode bewirkt nichts, aber abgeleitete Klassen können die-Methode überschreiben, um die entsprechende Funktionalität bereitzustellen.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts in den Textstream.Writes the text representation of a Boolean value to the text stream.

public:
 virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)

Parameter

value
Boolean

Der zu schreibende Boolean-Wert.The Boolean value to write.

Ausnahmen

Der TextWriter ist geschlossen.The TextWriter is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Boolean.ToString-Methode erzeugt.The text representation of the specified value is produced by calling the Boolean.ToString method.

Diese Methode gibt entweder Boolean.TrueString oder Boolean.FalseStringaus.This method outputs either Boolean.TrueString or Boolean.FalseString.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Textstream.Writes a character span to the text stream.

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

Parameter

buffer
ReadOnlySpan<Char>

Die zu schreibende Zeichenspanne.The character span to write.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen von "read- lyspan" erzeugt. Die Methode "destring".The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Gilt für: