TextWriter.Write Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Zapisuje dane w strumieniu tekstowym.

Przeciążenia

Write(String, Object, Object, Object)	Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object, Object, Object).
Write(Char[], Int32, Int32)	Zapisuje podarraj znaków w strumieniu tekstowym.
Write(String, Object[])	Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object[]).
Write(String, Object)	Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object).
Write(UInt64)	Zapisuje reprezentację tekstu 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego.
Write(UInt32)	Zapisuje reprezentację tekstu 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego.
Write(StringBuilder)	Zapisuje konstruktora ciągów w strumieniu tekstowym.
Write(String)	Zapisuje ciąg w strumieniu tekstowym.
Write(Single)	Zapisuje reprezentację tekstu wartości zmiennoprzecinkowej 4-bajtowej na strumień tekstowy.
Write(String, Object, Object)	Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object, Object).
Write(Object)	Zapisuje tekstową reprezentację obiektu w strumieniu tekstowym, wywołując metodę ToString dla tego obiektu.
Write(Int64)	Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.
Write(Int32)	Zapisuje reprezentację tekstu z 4-bajtową liczbą całkowitą ze znakiem do strumienia tekstowego.
Write(Double)	Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego.
Write(Decimal)	Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.
Write(Char[])	Zapisuje tablicę znaków w strumieniu tekstowym.
Write(Char)	Zapisuje znak w strumieniu tekstowym.
Write(Boolean)	Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym.
Write(ReadOnlySpan<Char>)	Zapisuje zakres znaków w strumieniu tekstowym.

Write(String, Object, Object, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object, Object, Object).

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.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

arg2

Object

Trzeci obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

format jest null.

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (co dla tego przeciążenia metody wynosi trzy).

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. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Złożone formatowanie.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz standardowe ciągi formatu daty i godziny i niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma trzy obiekty na liście parametrów, wartość indeksu musi zawsze wynosić 0, 1 lub 2. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je TextWriter.NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Char[], Int32, Int32)

Źródło:

TextWriter.cs

Zapisuje podarraj znaków w strumieniu tekstowym.

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 do zapisu danych.

index

Int32

Pozycja znaku w buforze, w którym należy rozpocząć pobieranie danych.

count

Int32

Liczba znaków do zapisania.

Wyjątki

ArgumentException

Długość buforu minus index jest mniejsza niż count.

ArgumentNullException

Parametr buffer jest null.

ArgumentOutOfRangeException

index lub count jest ujemna.

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Ta metoda zapisuje count znaków danych w tym TextWriter z tablicy znaków buffer rozpoczynającej się od pozycji index.

To przeciążenie jest równoważne przeciążeniu Write(Char[]) dla każdego znaku w buffer między index i (index + count).

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(String, Object[])

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object[]).

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.

arg

Object[]

Tablica obiektów zawierająca zero lub więcej obiektów do formatowania i zapisu.

Wyjątki

ArgumentNullException

format lub arg jest null.

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości tablicy arg.

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. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Złożone formatowanie.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz standardowe ciągi formatu daty i godziny i niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma tablicę na liście parametrów, wartość indeksu musi być zawsze mniejsza niż długość tablicy. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je TextWriter.NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(String, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object).

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.

arg0

Object

Obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

format jest null.

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (które dla tego przeciążenia metody jest jednym).

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. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Złożone formatowanie.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz standardowe ciągi formatu daty i godziny i niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma tylko jeden obiekt na liście parametrów, wartość indeksu zawsze musi wynosić 0. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je TextWriter.NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(UInt64)

Źródło:

TextWriter.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje reprezentację tekstu 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego.

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

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

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

Public Overridable Sub Write (value As ULong)

Parametry

value

UInt64

Liczba całkowita bez znaku 8 bajtów do zapisu.

Atrybuty

CLSCompliantAttribute

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody UInt64.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(UInt32)

Źródło:

TextWriter.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje reprezentację tekstu 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego.

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

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

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

Public Overridable Sub Write (value As UInteger)

Parametry

value

UInt32

Liczba całkowita bez znaku 4-bajtowa do zapisu.

Atrybuty

CLSCompliantAttribute

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody UInt32.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(StringBuilder)

Źródło:

TextWriter.cs

Zapisuje konstruktora ciągów w strumieniu tekstowym.

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

Uwagi

Ta metoda jest równoważna Write(stringBuilder.ToString()), ale używa metody StringBuilder.GetChunks, aby uniknąć tworzenia ciągu pośredniego.

Write(String)

Źródło:

TextWriter.cs

Zapisuje ciąg w strumieniu tekstowym.

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

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

To przeciążenie jest równoważne przeciążeniu Write(Char[]).

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je TextWriter.NewLine.

Jeśli value jest null, nic nie jest zapisywane w strumieniu tekstowym.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Write(String)
• Write(String)
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Single)

Źródło:

TextWriter.cs

Zapisuje reprezentację tekstu wartości zmiennoprzecinkowej 4-bajtowej na strumień tekstowy.

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

Wartość zmiennoprzecinkowa 4-bajtowa do zapisu.

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Single.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(String, Object, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg w strumieniu tekstowym przy użyciu tej samej semantyki co metoda Format(String, Object, Object).

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.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

format jest null.

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (co dla tego przeciążenia metody jest dwa).

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. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Złożone formatowanie.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz standardowe ciągi formatu daty i godziny i niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,długość][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez index jest null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma dwa obiekty na liście parametrów, wartość indeksu zawsze musi wynosić 0 lub 1. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException.
długości	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format, który jest używany jako ciąg formatu IFormattable.ToString.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je TextWriter.NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Object)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację obiektu w strumieniu tekstowym, wywołując metodę ToString dla tego obiektu.

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

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

To przeciążenie jest równoważne przeciążeniu Write(String).

Jeśli określony obiekt jest null, nie zostanie podjęta żadna akcja i nie zostanie zgłoszony wyjątek. W przeciwnym razie metoda ToString obiektu jest wywoływana w celu utworzenia reprezentacji ciągu, a wynikowy ciąg jest następnie zapisywany w strumieniu wyjściowym. Właściwość FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Int64)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.

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

Liczba całkowita ze znakiem 8 bajtów do zapisu.

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Int64.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Instrukcje: zapisywanie tekstu w pliku

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

Źródło:

TextWriter.cs

Zapisuje reprezentację tekstu z 4-bajtową liczbą całkowitą ze znakiem do strumienia tekstowego.

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

Liczba całkowita ze znakiem 4 bajtów do zapisu.

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Int32.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Double)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego.

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

Wartość zmiennoprzecinkowa 8-bajtowa do zapisu.

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Double.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Decimal)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.

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

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Właściwość FormatProvider, jeśli nie null, określa formatowanie specyficzne dla kultury.

Zobacz też

• StreamWriter
• StringWriter
• IFormatProvider
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Char[])

Źródło:

TextWriter.cs

Zapisuje tablicę znaków w strumieniu tekstowym.

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.

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.

Ta domyślna metoda wywołuje metodę Write(Char[], Int32, Int32) i przekazuje całą tablicę znaków. Jeśli tablica znaków jest null, nic nie jest zapisywane.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Write(Char[])
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Char)

Źródło:

TextWriter.cs

Zapisuje znak w strumieniu tekstowym.

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

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Ta metoda domyślna nic nie robi, ale klasy pochodne mogą zastąpić metodę w celu zapewnienia odpowiednich funkcji.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Write(Char)
• Write(Char)
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Boolean)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym.

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

Wyjątki

ObjectDisposedException

TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Boolean.ToString.

Ta metoda zwraca dane wyjściowe Boolean.TrueString lub Boolean.FalseString.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• StreamWriter
• StringWriter
• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(ReadOnlySpan<Char>)

Źródło:

TextWriter.cs

Zapisuje zakres znaków w strumieniu tekstowym.

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

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie ReadOnlySpan<Char>. ToString, metoda.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.