TextWriter.Write Metoda
Definicja
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 |
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ę |
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
format
to null
.
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
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 format
pliku , 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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Długość buforu minus index
jest mniejsza niż count
.
Parametr buffer
ma wartość null
.
index
lub count
jest ujemny.
Element TextWriter jest zamknięty.
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 buffer
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 i Stream we/wy
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
format
lub arg
to null
.
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
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 formatudaty 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]}
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 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 format
elemencie , 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ż
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream we/wy
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
format
to null
.
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
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
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 formatudaty 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]}
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 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. |
Wymagane są znaki nawiasów klamrowych wiodących i końcowych, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
elemencie , 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ż
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream we/wy
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Wyjątki
Element TextWriter jest zamknięty.
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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Wyjątki
Element TextWriter jest zamknięty.
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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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 null
wartość , 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)
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
format
to null
.
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
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
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 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. |
Wymagane są znaki wiodącego i końcowego nawiasu klamrowego "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
pliku , 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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
To przeciążenie jest równoważne przeciążeniu Write(String) .
Jeśli określony obiekt ma null
wartość , 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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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
Element TextWriter jest zamknięty.
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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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ż
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
Właściwość FormatProvider , jeśli nie null
, określa formatowanie specyficzne dla kultury.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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 null
wartość , nic nie jest zapisywane.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- Write(Char[])
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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ż
- Write(Char)
- Write(Char)
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Element TextWriter jest zamknięty.
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.TrueStringBoolean.FalseString.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- We/wy plików i Stream
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
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
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla