TextWriter.Write Metoda

Definicja

Zapisuje dane w strumieniu tekstowym.Writes data to a text stream.

Przeciążenia

Write(String, Object, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co Metoda Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia tekstu.Writes a subarray of characters to the text stream.

Write(String, Object[])

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(String, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(UInt64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu.Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

Zapisuje tekstową reprezentację wartości 4-bajtowej bez znaku do strumienia tekstu.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

Zapisuje konstruktora ciągów do strumienia tekstu.Writes a string builder to the text stream.

Write(String)

Zapisuje ciąg w strumieniu tekstowym.Writes a string to the text stream.

Write(Single)

Zapisuje tekstową reprezentację wartości 4-bajtowej zmiennoprzecinkowej w strumieniu tekstowym.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, Object, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object, Object, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(Object)

Zapisuje tekstową reprezentację obiektu do strumienia tekstowego, wywołując metodę ToString dla tego obiektu.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(Int64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

Zapisuje tekstową reprezentację wartości 4-bajtowej ze znakiem w strumieniu tekstowym.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej w strumieniu tekstowym.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.Writes the text representation of a decimal value to the text stream.

Write(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym.Writes a character array to the text stream.

Write(Char)

Zapisuje znak w strumieniu tekstowym.Writes a character to the text stream.

Write(Boolean)

Zapisuje tekstową reprezentację wartości Boolean w strumieniu tekstowym.Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków w strumieniu tekstowym.Writes a character span to the text stream.

Write(String, Object, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co Metoda Format(String, Object, Object).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)

Parametry

format
String

Ciąg formatu złożonego.A composite format string.

arg0
Object

Pierwszy obiekt do formatu i zapis.The first object to format and write.

arg1
Object

Drugi obiekt do formatu i zapisu.The second object to format and write.

Wyjątki

format jest null.format is null.

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

format nie jest prawidłowym ciągiem formatu złożonego.format is not a valid composite format string.

lub-or- Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (w przypadku tego przeciążenia metody są dwa).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).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Parametr format składa się z zera lub więcej przebiegów tekstu zmieszanych z zerem lub więcej indeksowanych symboli zastępczych o nazwie elementy formatu, które odpowiadają obiektowi na liście parametrów tej metody.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. Proces formatowania zamienia każdy element formatu na ciąg reprezentujący wartość odpowiedniego obiektu.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Składnia elementu format jest następująca:The syntax of a format item is as follows:

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

Elementy w nawiasach kwadratowych są opcjonalne.Elements in square brackets are optional. W tabeli poniżej opisano każdy element.The following table describes each element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz formatowanie złożone.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement OpisDescription
indeksindex Pozycja od zera na liście parametrów obiektu do sformatowania.The zero-based position in the parameter list of the object to be formatted. Jeśli obiekt określony przez indeks jest null, element formatu jest zastępowany przez String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Ponieważ to Przeciążenie ma dwa obiekty na liście parametrów, wartość indeksu musi być zawsze równa 0 lub 1.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. Jeśli w położeniu indeksu nie ma parametru, zostanie zgłoszony FormatException.If there is no parameter in the index position, a FormatException is thrown.
,Długość,length Minimalna liczba znaków w ciągu reprezentującym parametr.The minimum number of characters in the string representation of the parameter. W przypadku wartości dodatnich parametr jest wyrównany do prawej; w przypadku wartości ujemnej jest wyrównany do lewej.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania.A standard or custom format string that is supported by the object to be formatted. Możliwe wartości elementu FormatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Jeśli parametr FormatString nie zostanie określony, a obiekt do sformatowania implementuje interfejs IFormattable, null jest przenoszona jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.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.

Znaki wiodących i końcowych nawiasów klamrowych, "{" i "}", są wymagane.The leading and trailing brace characters, "{" and "}", are required. Aby określić pojedynczy znak nawiasu klamrowego w format, określ dwa początkowe lub końcowe znaki nawiasu klamrowego; oznacza to, "{{" lub "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.If a specified object is not referenced in the format string, it is ignored.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia tekstu.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)

Parametry

buffer
Char[]

Tablica znaków, z której mają zostać zapisane dane.The character array to write data from.

index
Int32

Pozycja znaku w buforze, od którego ma zostać rozpoczęte pobieranie danych.The character position in the buffer at which to start retrieving data.

count
Int32

Liczba znaków, jaka ma zostać zapisana.The number of characters to write.

Wyjątki

Długość buforu minus index jest mniejsza niż count.The buffer length minus index is less than count.

Parametr buffer ma wartość null.The buffer parameter is null.

index lub count jest wartością ujemną.index or count is negative.

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Ta metoda spowoduje zapisanie count znaków danych w tym TextWriter z tablicy znaków buffer, zaczynając od pozycji index.This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

To przeciążenie jest równoważne Write(Char[]) Przeciążenie dla każdego znaku w buffer między index i (index + count).This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(String, Object[])

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object[]).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())

Parametry

format
String

Ciąg formatu złożonego.A composite format string.

arg
Object[]

Tablica obiektów, która zawiera zero lub więcej obiektów do formatowania i zapisu.An object array that contains zero or more objects to format and write.

Wyjątki

Parametr format lub arg ma wartość null.format or arg is null.

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

format nie jest prawidłowym ciągiem formatu złożonego.format is not a valid composite format string.

lub-or- Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości tablicy arg.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Parametr format składa się z zera lub więcej przebiegów tekstu zmieszanych z zerem lub więcej indeksowanych symboli zastępczych o nazwie elementy formatu, które odpowiadają obiektowi na liście parametrów tej metody.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. Proces formatowania zamienia każdy element formatu na ciąg reprezentujący wartość odpowiedniego obiektu.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Składnia elementu format jest następująca:The syntax of a format item is as follows:

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

Elementy w nawiasach kwadratowych są opcjonalne.Elements in square brackets are optional. W tabeli poniżej opisano każdy element.The following table describes each element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz formatowanie złożone.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement OpisDescription
indeksindex Pozycja od zera na liście parametrów obiektu do sformatowania.The zero-based position in the parameter list of the object to be formatted. Jeśli obiekt określony przez indeks jest null, element formatu jest zastępowany przez String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Ponieważ to Przeciążenie ma tablicę na liście parametrów, wartość indeksu musi być zawsze mniejsza niż długość tablicy.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. Jeśli w położeniu indeksu nie ma parametru, zostanie zgłoszony FormatException.If there is no parameter in the index position, a FormatException is thrown.
,Długość,length Minimalna liczba znaków w ciągu reprezentującym parametr.The minimum number of characters in the string representation of the parameter. W przypadku wartości dodatnich parametr jest wyrównany do prawej; w przypadku wartości ujemnej jest wyrównany do lewej.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania.A standard or custom format string that is supported by the object to be formatted. Możliwe wartości elementu FormatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Jeśli parametr FormatString nie zostanie określony, a obiekt do sformatowania implementuje interfejs IFormattable, null jest przenoszona jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.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.

Znaki wiodących i końcowych nawiasów klamrowych, "{" i "}", są wymagane.The leading and trailing brace characters, "{" and "}", are required. Aby określić pojedynczy znak nawiasu klamrowego w format, określ dwa początkowe lub końcowe znaki nawiasu klamrowego; oznacza to, "{{" lub "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.If a specified object is not referenced in the format string, it is ignored.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(String, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object).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)

Parametry

format
String

Ciąg formatu złożonego.A composite format string.

arg0
Object

Obiekt do formatowania i zapisu.The object to format and write.

Wyjątki

format jest null.format is null.

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

format nie jest prawidłowym ciągiem formatu złożonego.format is not a valid composite format string.

lub-or- Indeks elementu formatu jest mniejszy niż 0 (zero) lub większa lub równa liczbie obiektów do sformatowania (w przypadku tego przeciążenia metody jest jeden).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).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Parametr format składa się z zera lub więcej przebiegów tekstu zmieszanych z zerem lub więcej indeksowanych symboli zastępczych o nazwie elementy formatu, które odpowiadają obiektowi na liście parametrów tej metody.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. Proces formatowania zamienia każdy element formatu na ciąg reprezentujący wartość odpowiedniego obiektu.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Składnia elementu format jest następująca:The syntax of a format item is as follows:

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

Elementy w nawiasach kwadratowych są opcjonalne.Elements in square brackets are optional. W tabeli poniżej opisano każdy element.The following table describes each element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz formatowanie złożone.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement OpisDescription
indeksindex Pozycja od zera na liście parametrów obiektu do sformatowania.The zero-based position in the parameter list of the object to be formatted. Jeśli obiekt określony przez indeks jest null, element formatu jest zastępowany przez String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Ponieważ to Przeciążenie ma tylko jeden obiekt na liście parametrów, wartość indeksu musi być zawsze równa 0.Because this overload has only a single object in its parameter list, the value of index must always be 0. Jeśli w położeniu indeksu nie ma parametru, zostanie zgłoszony FormatException.If there is no parameter in the index position, a FormatException is thrown.
,Długość,length Minimalna liczba znaków w ciągu reprezentującym parametr.The minimum number of characters in the string representation of the parameter. W przypadku wartości dodatnich parametr jest wyrównany do prawej; w przypadku wartości ujemnej jest wyrównany do lewej.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania.A standard or custom format string that is supported by the object to be formatted. Możliwe wartości elementu FormatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Jeśli parametr FormatString nie zostanie określony, a obiekt do sformatowania implementuje interfejs IFormattable, null jest przenoszona jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.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.

Znaki wiodących i końcowych nawiasów klamrowych, "{" i "}", są wymagane.The leading and trailing brace characters, "{" and "}", are required. Aby określić pojedynczy znak nawiasu klamrowego w format, określ dwa początkowe lub końcowe znaki nawiasu klamrowego; oznacza to, "{{" lub "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

.. Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.If a specified object is not referenced in the format string, it is ignored.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(UInt64)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu.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)

Parametry

value
UInt64

8-bajtowa liczba całkowita bez znaku do zapisania.The 8-byte unsigned integer to write.

Atrybuty

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody UInt64.ToString.The text representation of the specified value is produced by calling the UInt64.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(UInt32)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje tekstową reprezentację wartości 4-bajtowej bez znaku do strumienia tekstu.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)

Parametry

value
UInt32

4-bajtowa liczba całkowita bez znaku do zapisania.The 4-byte unsigned integer to write.

Atrybuty

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody UInt32.ToString.The text representation of the specified value is produced by calling the UInt32.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(StringBuilder)

Zapisuje konstruktora ciągów do strumienia tekstu.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)

Parametry

value
StringBuilder

Ciąg, jako Konstruktor ciągów, do zapisu w strumieniu tekstu.The string, as a string builder, to write to the text stream.

Uwagi

Ta metoda jest równoważna z Write(stringBuilder.ToString()), ale używa metody StringBuilder.GetChunks, aby uniknąć tworzenia ciągu pośredniego.This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Write(String)

Zapisuje ciąg w strumieniu tekstowym.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)

Parametry

value
String

Ciąg do zapisu.The string to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

To przeciążenie jest równoważne przeciążeniu Write(Char[]).This overload is equivalent to the Write(Char[]) overload.

Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Jeśli value jest null, nic nie jest zapisywana w strumieniu tekstu.If value is null, nothing is written to the text stream.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Single)

Zapisuje tekstową reprezentację wartości 4-bajtowej zmiennoprzecinkowej w strumieniu tekstowym.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)

Parametry

value
Single

4-bajtowa wartość zmiennoprzecinkowa do zapisu.The 4-byte floating-point value to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody Single.ToString.The text representation of the specified value is produced by calling the Single.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(String, Object, Object, Object)

Zapisuje sformatowany ciąg w strumieniu tekstowym, używając tej samej semantyki co Metoda Format(String, Object, Object, Object).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)

Parametry

format
String

Ciąg formatu złożonego.A composite format string.

arg0
Object

Pierwszy obiekt do formatu i zapis.The first object to format and write.

arg1
Object

Drugi obiekt do formatu i zapisu.The second object to format and write.

arg2
Object

Trzeci obiekt do formatowania i zapisu.The third object to format and write.

Wyjątki

format jest null.format is null.

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

format nie jest prawidłowym ciągiem formatu złożonego.format is not a valid composite format string.

lub-or- Indeks elementu formatu jest mniejszy niż 0 (zero) lub większa lub równa liczbie obiektów do sformatowania (dla tego przeciążenia metody jest trzy).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).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Parametr format składa się z zera lub więcej przebiegów tekstu zmieszanych z zerem lub więcej indeksowanych symboli zastępczych o nazwie elementy formatu, które odpowiadają obiektowi na liście parametrów tej metody.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. Proces formatowania zamienia każdy element formatu na ciąg reprezentujący wartość odpowiedniego obiektu.The formatting process replaces each format item with the string representation of the value of the corresponding object.

Składnia elementu format jest następująca:The syntax of a format item is as follows:

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

Elementy w nawiasach kwadratowych są opcjonalne.Elements in square brackets are optional. W tabeli poniżej opisano każdy element.The following table describes each element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz formatowanie złożone.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

ElementElement OpisDescription
indeksindex Pozycja od zera na liście parametrów obiektu do sformatowania.The zero-based position in the parameter list of the object to be formatted. Jeśli obiekt określony przez indeks jest null, element formatu jest zastępowany przez String.Empty.If the object specified by index is null, the format item is replaced by String.Empty. Ponieważ to Przeciążenie ma trzy obiekty na liście parametrów, wartość indeksu musi być zawsze równa 0, 1 lub 2.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. Jeśli w położeniu indeksu nie ma parametru, zostanie zgłoszony FormatException.If there is no parameter in the index position, a FormatException is thrown.
,Długość,length Minimalna liczba znaków w ciągu reprezentującym parametr.The minimum number of characters in the string representation of the parameter. W przypadku wartości dodatnich parametr jest wyrównany do prawej; w przypadku wartości ujemnej jest wyrównany do lewej.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:FormatString:formatString Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania.A standard or custom format string that is supported by the object to be formatted. Możliwe wartości elementu FormatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu.Possible values for formatString are the same as the values supported by the object's ToString(string format) method. Jeśli parametr FormatString nie zostanie określony, a obiekt do sformatowania implementuje interfejs IFormattable, null jest przenoszona jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.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.

Znaki wiodących i końcowych nawiasów klamrowych, "{" i "}", są wymagane.The leading and trailing brace characters, "{" and "}", are required. Aby określić pojedynczy znak nawiasu klamrowego w format, określ dwa początkowe lub końcowe znaki nawiasu klamrowego; oznacza to, "{{" lub "}}".To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je TextWriter.NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.If a specified object is not referenced in the format string, it is ignored.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Object)

Zapisuje tekstową reprezentację obiektu do strumienia tekstowego, wywołując metodę ToString dla tego obiektu.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)

Parametry

value
Object

Obiekt do zapisania.The object to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

To przeciążenie jest równoważne przeciążeniu Write(String).This overload is equivalent to the Write(String) overload.

Jeśli określony obiekt jest null, żadna akcja nie zostanie podjęta i nie zostanie zgłoszony żaden wyjątek.If the specified object is null, no action is taken and no exception is thrown. W przeciwnym razie metoda ToString obiektu jest wywoływana, aby utworzyć reprezentację ciągu, a wynikowy ciąg jest następnie zapisywana w strumieniu wyjściowym.Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. Właściwość FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Int64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.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)

Parametry

value
Int64

8-bajtowa liczba całkowita ze znakiem do zapisania.The 8-byte signed integer to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody Int64.ToString.The text representation of the specified value is produced by calling the Int64.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Instrukcje: zapisywanie tekstu w plikuHow to: Write Text to a File

Zobacz też

Write(Int32)

Zapisuje tekstową reprezentację wartości 4-bajtowej ze znakiem w strumieniu tekstowym.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)

Parametry

value
Int32

4-bajtowa liczba całkowita ze znakiem do zapisania.The 4-byte signed integer to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody Int32.ToString.The text representation of the specified value is produced by calling the Int32.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Double)

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej w strumieniu tekstowym.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)

Parametry

value
Double

8-bajtowa wartość zmiennoprzecinkowa do zapisu.The 8-byte floating-point value to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody Double.ToString.The text representation of the specified value is produced by calling the Double.ToString method. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Decimal)

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.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)

Parametry

value
Decimal

Wartość dziesiętna do zapisania.The decimal value to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Właściwość FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.The FormatProvider property, if not null, specifies the culture-specific formatting.

Zobacz też

Write(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym.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())

Parametry

buffer
Char[]

Tablica znaków do zapisu w strumieniu tekstowym.The character array to write to the text stream.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Ta metoda nie przeszukuje określonego ciągu dla pojedynczych znaków nowego wiersza (0x000a w formacie szesnastkowym) i zastąpi je NewLine.This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

Ta metoda domyślna wywołuje metodę Write(Char[], Int32, Int32) i przekazuje całą tablicę znaków.This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. Jeśli tablica znaków jest null, nic nie jest zapisywana.If the character array is null, nothing is written.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Char)

Zapisuje znak w strumieniu tekstowym.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)

Parametry

value
Char

Znak do zapisu w strumieniu tekstu.The character to write to the text stream.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Ta metoda domyślna nie wykonuje żadnych operacji, ale klasy pochodne mogą przesłaniać metodę w celu zapewnienia odpowiedniej funkcjonalności.This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(Boolean)

Zapisuje tekstową reprezentację wartości Boolean w strumieniu tekstowym.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)

Parametry

value
Boolean

Wartość Boolean do zapisania.The Boolean value to write.

Wyjątki

TextWriter jest zamknięty.The TextWriter is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie metody Boolean.ToString.The text representation of the specified value is produced by calling the Boolean.ToString method.

Ta metoda wyprowadza Boolean.TrueString lub Boolean.FalseString.This method outputs either Boolean.TrueString or Boolean.FalseString.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Zobacz też

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków w strumieniu tekstowym.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))

Parametry

buffer
ReadOnlySpan<Char>

Zakres znaków do zapisania.The character span to write.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowana przez wywołanie ReadOnlySpan. Metoda ToString .The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy