TextWriter.Write Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zapisuje data do textového streamu.
Přetížení
Write(String, Object, Object, Object) |
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object, Object) metoda . |
Write(Char[], Int32, Int32) |
Zapíše dílčí pole znaků do textového streamu. |
Write(String, Object[]) |
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object[]) metoda . |
Write(String, Object) |
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object) metoda . |
Write(UInt64) |
Zapíše textovou reprezentaci 8 bajtového celého čísla bez znaménka do textového streamu. |
Write(UInt32) |
Zapíše textovou reprezentaci 4 bajtového celého čísla bez znaménka do textového streamu. |
Write(StringBuilder) |
Zapíše tvůrce řetězců do textového streamu. |
Write(String) |
Zapíše řetězec do textového streamu. |
Write(Single) |
Zapíše textovou reprezentaci 4 bajtové hodnoty s plovoucí desetinou čárkou do textového streamu. |
Write(String, Object, Object) |
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object) metoda . |
Write(Object) |
Zapíše textovou reprezentaci objektu do textového streamu voláním |
Write(Int64) |
Zapíše do textového datového proudu textovou reprezentaci 8 bajtů se psaných čísly se sadou 8 bajtů. |
Write(Int32) |
Zapíše textovou reprezentaci 4 bajtového celého čísla se 4 bajty do textového datového proudu. |
Write(Double) |
Zapíše textovou reprezentaci hodnoty 8 bajtů s plovoucí desetinou čárkou do textového streamu. |
Write(Decimal) |
Zapíše textovou reprezentaci desetinné hodnoty do textového proudu. |
Write(Char[]) |
Zapíše pole znaků do textového streamu. |
Write(Char) |
Zapíše znak do textového streamu. |
Write(Boolean) |
Zapíše textovou reprezentaci |
Write(ReadOnlySpan<Char>) |
Zapíše rozsah znaků do textového streamu. |
Write(String, Object, Object, Object)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako 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
Řetězec složeného formátu.
- arg0
- Object
První objekt pro formátování a zápis.
- arg1
- Object
Druhý objekt pro formátování a zápis.
- arg2
- Object
Třetí objekt pro formátování a zápis.
Výjimky
format
je null
.
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
format
není platný řetězec složeného formátu.
-nebo-
Index položky formátu je menší než 0 (nula) nebo větší nebo roven počtu objektů, které mají být formátovány (což je pro přetížení této metody tři).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na jeho řetězcové vyjádření a k vložení této reprezentace do řetězce. .NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o funkci složeného formátování najdete v tématu Složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o specifikátorech formátu data a času najdete v tématech Řetězce standardního formátu data a času a Vlastní řetězce formátu data a času.
Další informace o specifikátorech formátu výčtu najdete v tématu Výčtové řetězce formátu.
Další informace o formátování najdete v tématu Typy formátování.
Parametr format
se skládá z nula nebo více spuštění textu intermixovaného s nula nebo více indexovaných zástupných symbolů, nazývaných položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu řetězcovou reprezentací hodnoty odpovídajícího objektu.
Syntaxe položky formátu je následující:
{index[,length][:formatString]}
Prvky v hranatých závorkách jsou volitelné. Následující tabulka popisuje jednotlivé prvky. Další informace o funkci složeného formátování, včetně syntaxe položky formátu, najdete v tématu Složené formátování.
Element | Popis |
---|---|
index | Pozice založená na nule v seznamu parametrů objektu, který má být formátován. Pokud je null objekt určený indexem , nahradí se položka formátu hodnotou String.Empty. Vzhledem k tomu, že toto přetížení má v seznamu parametrů tři objekty, hodnota indexu musí být vždy 0, 1 nebo 2. Pokud v pozici indexu není žádný parametr, vyvolá se FormatException hodnota . |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Je-li pozitivní, parametr je zarovnán doprava; pokud je záporný, je zarovnán doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec, který je podporován objektem, který má být formátován. Možné hodnoty pro formatString jsou stejné jako hodnoty podporované metodou objektu ToString(string format) . Pokud formatString není zadán a objekt, který má být formátován implementuje IFormattable rozhraní, null je předán jako hodnota parametru format , který se používá jako IFormattable.ToString řetězec formátu. |
Počáteční a koncové složené závorky { a } jsou povinné. Pokud chcete v format
zadat jednu literálovou složenou závorku, zadejte dva počáteční nebo koncové znaky složené závorky, tj. {{nebo }}.
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je za TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, je ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Char[], Int32, Int32)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše do textového datového proudu podadresu znaků.
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[]
Pole znaků, ze které se mají zapisovat data.
- index
- Int32
Pozice znaku ve vyrovnávací paměti, ve které se mají začít načítat data.
- count
- Int32
Počet znaků k zápisu.
Výjimky
Délka vyrovnávací paměti mínus index
je menší než count
.
Parametr buffer
je null
.
index
nebo count
je negativní.
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Tato metoda zapíše count
znaky dat do této TextWriter
z buffer
pole znaků začínající na pozici index
.
Toto přetížení je ekvivalentní Write(Char[]) přetížení pro každý znak mezi index
buffer
a (index
+ count
).
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(String, Object[])
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako 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
Řetězec složeného formátu.
- arg
- Object[]
Pole objektů, které obsahuje nula nebo více objektů pro formátování a zápis.
Výjimky
format
nebo arg
je null
.
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
format
není platný řetězec složeného formátu.
-nebo-
Index položky formátu je menší než 0 (nula) nebo větší nebo roven délce arg
pole.
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na jeho řetězcovou reprezentaci a k vložení této reprezentace do řetězce. .NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o funkci složeného formátování najdete v tématu Složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o specifikátorech formátu data a času najdete v tématech Standardní řetězce formátu data a času a Vlastní řetězce formátu data a času.
Další informace o specifikátorech formátu výčtu najdete v tématu Řetězce formátu výčtu.
Další informace o formátování najdete v tématu Typy formátování.
Parametr format
se skládá z nula nebo více spuštění textu intermixovaného s nula nebo více indexovaných zástupných symbolů, označovaných jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu řetězcovou reprezentací hodnoty odpovídajícího objektu.
Syntaxe položky formátu je následující:
{index[,length][:formatString]}
Prvky v hranatých závorkách jsou volitelné. Následující tabulka popisuje jednotlivé prvky. Další informace o funkci složeného formátování, včetně syntaxe položky formátu, najdete v tématu Složené formátování.
Element | Popis |
---|---|
index | Pozice založená na nule v seznamu parametrů objektu, který se má formátovat. Pokud je null objekt určený indexem , nahradí se String.Emptypoložka formátu hodnotou . Vzhledem k tomu, že toto přetížení obsahuje pole v seznamu parametrů, musí být hodnota indexu vždy menší než délka pole. Pokud v pozici indexu není žádný parametr, FormatException vyvolá se parametr . |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnán doprava; Pokud je záporný, je zarovnaný doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec, který je podporován objektem, který má být formátován. Možné hodnoty pro formatString jsou stejné jako hodnoty podporované metodou objektu ToString(string format) . Pokud formatString není zadán a objekt, který má být formátován implementuje IFormattable rozhraní, null je předán jako hodnota parametru format , který se používá jako formátovací IFormattable.ToString řetězec. |
Znaky počáteční a koncové složené závorky, {a}, jsou povinné. Pokud chcete zadat jednu literálovou závorku v format
, zadejte dva počáteční nebo koncové znaky složené závorky, to znamená {{nebo }}.
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je znakem TextWriter.NewLine.
Pokud se na zadaný objekt ve formátovacím řetězci neodkazuje, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(String, Object)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako 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
Řetězec složeného formátu.
- arg0
- Object
Objekt, který se má formátovat a zapisovat.
Výjimky
format
je null
.
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
format
není platný řetězec složeného formátu.
-nebo-
Index položky formátu je menší než 0 (nula) nebo větší nebo roven počtu objektů, které se mají formátovat (což je pro přetížení této metody jedna).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na jeho řetězcovou reprezentaci a k vložení této reprezentace do řetězce. .NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o funkci složeného formátování najdete v tématu Složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o specifikátorech formátu data a času najdete v tématech Standardní řetězce formátu data a času a Vlastní řetězce formátu data a času.
Další informace o specifikátorech formátu výčtu najdete v tématu Řetězce formátu výčtu.
Další informace o formátování najdete v tématu Typy formátování.
Parametr format
se skládá z nula nebo více spuštění textu intermixovaného s nula nebo více indexovaných zástupných symbolů, označovaných jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu řetězcovou reprezentací hodnoty odpovídajícího objektu.
Syntaxe položky formátu je následující:
{index[,length][:formatString]}
Prvky v hranatých závorkách jsou volitelné. Následující tabulka popisuje jednotlivé prvky. Další informace o funkci složeného formátování, včetně syntaxe položky formátu, najdete v tématu Složené formátování.
Element | Popis |
---|---|
index | Pozice založená na nule v seznamu parametrů objektu, který se má formátovat. Pokud je null objekt určený indexem , nahradí se String.Emptypoložka formátu hodnotou . Vzhledem k tomu, že toto přetížení má v seznamu parametrů pouze jeden objekt, hodnota indexu musí být vždy 0. Pokud v pozici indexu není žádný parametr, FormatException vyvolá se parametr . |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnán doprava; Pokud je záporný, je zarovnaný doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec, který je podporován objektem, který má být formátován. Možné hodnoty pro formatString jsou stejné jako hodnoty podporované metodou objektu ToString(string format) . Pokud formatString není zadán a objekt, který má být formátován implementuje IFormattable rozhraní, null je předán jako hodnota parametru format , který se používá jako formátovací IFormattable.ToString řetězec. |
Znaky počáteční a koncové složené závorky, {a}, jsou povinné. Pokud chcete zadat jednu literálovou závorku v format
, zadejte dva počáteční nebo koncové znaky složené závorky, to znamená {{nebo }}.
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je znakem TextWriter.NewLine.
Pokud se na zadaný objekt ve formátovacím řetězci neodkazuje, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(UInt64)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
Zapíše textovou reprezentaci 8 bajtového celého čísla bez znaménka do textového streamu.
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
8-bajt bez znaménka celé číslo pro zápis.
- Atributy
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním UInt64.ToString metody. Vlastnost TextWriter.FormatProvider , pokud ne null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(UInt32)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
Zapíše textovou reprezentaci 4 bajtového celého čísla bez znaménka do textového streamu.
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
4 bajtové celé číslo bez znaménka pro zápis.
- Atributy
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním UInt32.ToString metody . Vlastnost TextWriter.FormatProvider , pokud není null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(StringBuilder)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše tvůrce řetězců do textového streamu.
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
Řetězec, jako tvůrce řetězců, který se má zapisovat do textového streamu.
Poznámky
Tato metoda je ekvivalentní k Write(stringBuilder.ToString())
, ale používá metodu StringBuilder.GetChunks , aby se zabránilo vytvoření zprostředkujícího řetězce.
Platí pro
Write(String)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše řetězec do textového streamu.
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
Řetězec určený pro zápis
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Toto přetížení je ekvivalentní Write(Char[]) přetížení.
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je za TextWriter.NewLine.
Pokud value
je null
, do textového streamu se nic nepíše.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- Write(String)
- Write(String)
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Single)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše textovou reprezentaci 4 bajtové hodnoty s plovoucí desetinou čárkou do textového streamu.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
Parametry
- value
- Single
4 bajtová hodnota s plovoucí desetinou čárkou, která se má zapisovat.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním Single.ToString metody . Vlastnost TextWriter.FormatProvider , pokud není null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(String, Object, Object)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako 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
Řetězec složeného formátu.
- arg0
- Object
První objekt pro formátování a zápis.
- arg1
- Object
Druhý objekt pro formátování a zápis.
Výjimky
format
je null
.
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
format
není platný řetězec složeného formátu.
-nebo-
Index položky formátu je menší než 0 (nula) nebo větší nebo roven počtu objektů, které mají být formátovány (což je pro přetížení této metody dva).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na jeho řetězcové vyjádření a k vložení této reprezentace do řetězce. .NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o funkci složeného formátování najdete v tématu Složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o specifikátorech formátu data a času najdete v tématech Řetězce standardního formátu data a času a Vlastní řetězce formátu data a času.
Další informace o specifikátorech formátu výčtu najdete v tématu Výčtové řetězce formátu.
Další informace o formátování najdete v tématu Typy formátování.
Parametr format
se skládá z nula nebo více spuštění textu intermixovaného s nula nebo více indexovaných zástupných symbolů, nazývaných položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu řetězcovou reprezentací hodnoty odpovídajícího objektu.
Syntaxe položky formátu je následující:
{index[,length][:formatString]}
Prvky v hranatých závorkách jsou volitelné. Následující tabulka popisuje jednotlivé prvky. Další informace o funkci složeného formátování, včetně syntaxe položky formátu, najdete v tématu Složené formátování.
Element | Popis |
---|---|
index | Pozice založená na nule v seznamu parametrů objektu, který má být formátován. Pokud je null objekt určený indexem , nahradí se položka formátu hodnotou String.Empty. Vzhledem k tomu, že toto přetížení má v seznamu parametrů dva objekty, hodnota indexu musí být vždy 0 nebo 1. Pokud v pozici indexu není žádný parametr, vyvolá se FormatException hodnota . |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Je-li pozitivní, parametr je zarovnán doprava; pokud je záporný, je zarovnán doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec, který je podporován objektem, který má být formátován. Možné hodnoty pro formatString jsou stejné jako hodnoty podporované metodou objektu ToString(string format) . Pokud formatString není zadán a objekt, který má být formátován implementuje IFormattable rozhraní, null je předán jako hodnota parametru format , který se používá jako IFormattable.ToString řetězec formátu. |
Počáteční a koncové složené závorky { a } jsou povinné. Pokud chcete v format
zadat jednu literálovou složenou závorku, zadejte dva počáteční nebo koncové znaky složené závorky, tj. {{nebo }}.
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je za TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, je ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Object)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše textovou reprezentaci objektu do textového streamu voláním ToString
metody pro tento objekt.
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
Objekt k zápisu.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Toto přetížení je ekvivalentní Write(String) přetížení.
Pokud je null
zadaný objekt , neprovedou se žádné akce a nevyvolá se žádná výjimka. V opačném případě je volána metoda objektu ToString
k vytvoření řetězcové reprezentace a výsledný řetězec se pak zapíše do výstupního datového proudu. Vlastnost FormatProvider , pokud není null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Int64)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše do textového streamu textovou reprezentaci 8 bajtového celého čísla.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
Parametry
- value
- Int64
8 bajtové celé číslo se signýmým číslem pro zápis.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním Int64.ToString metody. Vlastnost TextWriter.FormatProvider , pokud ne null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Postupy: Zápis textu do souboru
Viz také
Platí pro
Write(Int32)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše do textového datového proudu textovou reprezentaci 4 bajtového celého čísla.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
Parametry
- value
- Int32
4 bajtové celé číslo se signoumimi sadou pro zápis.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním Int32.ToString metody. Vlastnost TextWriter.FormatProvider , pokud ne null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Double)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše do textového datového proudu textovou reprezentaci hodnoty s plovoucí desetinou čárkou o velikosti 8 bajtů.
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
Hodnota 8 bajtů s plovoucí desetinou čárkou, která se má zapsat.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním Double.ToString metody. Vlastnost TextWriter.FormatProvider , pokud ne null
, určuje formátování specifické pro jazykovou verzi.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Decimal)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše textovou reprezentaci desetinné hodnoty do textového streamu.
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
Desetinná hodnota, která se má zapsat.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Vlastnost FormatProvider , pokud ne null
, určuje formátování specifické pro jazykovou verzi.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Char[])
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše pole znaků do textového streamu.
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[]
Pole znaků pro zápis do textového streamu.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Tato metoda nevyhledává v zadaném řetězci jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nenahrazuje je znakem NewLine.
Tato výchozí metoda volá metodu Write(Char[], Int32, Int32) a předává celé pole znaků. Pokud je null
pole znaků , nic se nepíše.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- Write(Char[])
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Char)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše znak do textového streamu.
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 pro zápis do textového streamu.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Tato výchozí metoda nedělá nic, ale odvozené třídy mohou přepsat metodu, aby poskytly odpovídající funkce.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- Write(Char)
- Write(Char)
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(Boolean)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše textovou Boolean
reprezentaci hodnoty do textového streamu.
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
Hodnota Boolean
, která se má zapsat.
Výjimky
Je TextWriter zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním Boolean.ToString metody.
Tato metoda vypíše buď Boolean.TrueString nebo Boolean.FalseString.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Viz také
- StreamWriter
- StringWriter
- Vstupně-výstupní operace souborů a Stream
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(ReadOnlySpan<Char>)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše rozsah znaků do textového streamu.
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>
Rozsah znaku, který se má psát.
Poznámky
Textová reprezentace zadané hodnoty je vytvořena voláním ReadOnlySpan<Char>. ToString – metoda.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro