TextWriter.Write Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.IO.dll

Zestaw:: System.Runtime.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje dane w strumieniu tekstowym.

Przeciążenia

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

Write(String, Object, Object, Object)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object, Object, Object) metoda.

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

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 formatu i zapis.

arg1: Object

Drugi obiekt do formatu i zapisu.

arg2: Object

Trzeci obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

format to null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 niż 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 Formatowanie złożone.
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 oraz 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 zmieszanego 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[,length][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W tabeli poniżej 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.

Element	Opis
index	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to `null`, element formatu jest zastępowany 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 w pozycji indeksu nie ma parametru, FormatException zgłaszany jest parametr .
,length	Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania. Możliwe wartości parametru formatString są takie same jak wartości obsługiwane przez metodę obiektu `ToString(string format)` . Jeśli parametr formatString nie jest określony i obiekt do sformatowania implementuje IFormattable interfejs, `null` jest przekazywany jako wartość parametru `format` , który jest używany jako IFormattable.ToString ciąg formatu.

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

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

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.

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

Zobacz też

Dotyczy

Write(Char[], Int32, Int32)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje podarraj znaków do strumienia tekstu.

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, jaka ma zostać zapisana.

Wyjątki

ArgumentException

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

ArgumentNullException

Parametr buffer ma wartość null.

ArgumentOutOfRangeException

index lub count jest ujemny.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Ta metoda zapisze count do tej TextWriter wartości znaki z buffer tablicy znaków rozpoczynającej się od pozycji index.

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

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

Zobacz też

Dotyczy

Write(String, Object[])

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object[]) metoda.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params 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 to null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo w następujących tematach formatowania:

Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.
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 oraz 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ą częścią 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[,length][:formatString]}

Element	Opis
index	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to `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 , FormatException jest zgłaszany.
,length	Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę obiektu `ToString(string format)` . Jeśli formatString nie jest określony i obiekt do sformatowania implementuje IFormattable interfejs, `null` jest przekazywany jako wartość `format` parametru, który jest używany jako IFormattable.ToString ciąg formatu.

Wymagane są znaki nawiasów klamrowych wiodących i końcowych, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w formatelemencie , 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ąp je znakiem TextWriter.NewLine.

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.

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

Zobacz też

Dotyczy

Write(String, Object)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object) metoda.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, 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 to null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 jednym).

Uwagi

Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.
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 oraz 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.

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

{index[,length][:formatString]}

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

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

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.

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

Zobacz też

Dotyczy

Write(UInt64)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie UInt64.ToString metody . 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ż

Dotyczy

Write(UInt32)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

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

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

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie UInt32.ToString metody . 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ż

Dotyczy

Write(StringBuilder)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Ź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 metodzie Write(stringBuilder.ToString()), ale używa StringBuilder.GetChunks metody , aby uniknąć tworzenia ciągu pośredniego.

Dotyczy

Write(String)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje ciąg w strumieniu tekstowym.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (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.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 znakiem TextWriter.NewLine.

Jeśli value parametr ma nullwartość , nic nie jest zapisywane w strumieniu tekstowym.

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

Zobacz też

Dotyczy

Write(Single)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje reprezentację tekstową 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

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Single.ToString metody . 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ż

Dotyczy

Write(String, Object, Object)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje sformatowany ciąg do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object, Object) metoda.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object arg0, 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 formatu i zapis.

arg1: Object

Drugi obiekt do formatu i zapisu.

Wyjątki

ArgumentNullException

format to null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 dwa).

Uwagi

Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.
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 oraz 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.

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

{index[,length][:formatString]}

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

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

Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.

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

Zobacz też

Dotyczy

Write(Object)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje reprezentację tekstową obiektu w strumieniu tekstowym przez wywołanie ToString metody na tym obiekcie.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (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.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

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

Jeśli określony obiekt ma nullwartość , nie jest wykonywana żadna akcja i nie jest zgłaszany żaden wyjątek. W przeciwnym razie metoda obiektu jest wywoływana ToString 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ż

Dotyczy

Write(Int64)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje reprezentację tekstową 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

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Int64.ToString metody . 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ż

Dotyczy

Write(Int32)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

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

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

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Int32.ToString metody . 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ż

Dotyczy

Write(Double)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

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

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

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Double.ToString metody . 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ż

Dotyczy

Write(Decimal)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje reprezentację tekstową 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 zapisania.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

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

Zobacz też

Dotyczy

Write(Char[])

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje tablicę znaków do strumienia tekstu.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (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

Element TextWriter jest zamknięty.

IOException

Wystąpi 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 znakiem NewLine.

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

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

Zobacz też

Dotyczy

Write(Char)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje znak do strumienia tekstu.

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

abstract member Write : char -> unit
override this.Write : char -> unit

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

Parametry

value: Char

Znak do zapisu w strumieniu tekstu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

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

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

Zobacz też

Dotyczy

Write(Boolean)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Ź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

Boolean Wartość do zapisania.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Wystąpi błąd We/Wy.

Uwagi

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

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

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

Zobacz też

Dotyczy

Write(ReadOnlySpan<Char>)

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Źródło:: TextWriter.cs

Zapisuje zakres znaków do strumienia tekstu.

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.

Uwagi

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

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

Dotyczy