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, ReadOnlySpan<Object>) |
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>). |
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 8bajtů bez znaménka do textového streamu. |
Write(UInt32) |
Zapíše textovou reprezentaci 4bajtů 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 4bajtů 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 datového proudu voláním |
Write(Int64) |
Zapíše textovou reprezentaci 8 bajtového celého čísla do textového streamu. |
Write(Int32) |
Zapíše textovou reprezentaci 4bajtů podepsaného celé číslo do textového streamu. |
Write(Double) |
Zapíše textovou reprezentaci hodnoty s plovoucí desetinou čárkou 8 bajtů do textového datového proudu. |
Write(Decimal) |
Zapíše textovou reprezentaci desetinné hodnoty do textového streamu. |
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 hodnoty |
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
Složený formátovací řetězec.
- 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
.
TextWriter je 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 toto přetížení metody tři).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na ř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 o formátování:
Další informace o funkci složeného formátování naleznete v tématu složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce čí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ématu 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 naleznete v tématu Formát řetězců výčtu.
Další informace o formátování naleznete v tématu Typy formátování.
Parametr format
se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými 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[, délka][: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, naleznete 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 objekt určený indexem null , položka formátu se nahradí 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 neexistuje žádný parametr, vyvolá se FormatException. |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnaný doprava; pokud je záporná, je zarovnaná doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec podporovaný objektem, který má být formátován. Možné hodnoty formatString jsou stejné jako hodnoty podporované metodou ToString(string format) objektu. Pokud není zadán formatString a objekt, který se má formátovat, implementuje rozhraní IFormattable, null se předá jako hodnota parametru format , který se používá jako řetězec formátu IFormattable.ToString. |
Jsou vyžadovány počáteční a koncové znaky složené závorky {a }. Chcete-li v format
zadat jeden znak složené závorky literálu, zadejte dva počáteční nebo koncové znaky složené závorky; to znamená {{{ nebo "}}".
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 dílčí pole znaků do textového streamu.
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ů pro zápis dat z.
- index
- Int32
Pozice znaku ve vyrovnávací paměti, ve které se mají začít načítat data.
- count
- Int32
Počet znaků, které se mají napsat.
Výjimky
Délka vyrovnávací paměti minus index
je menší než count
.
Parametr buffer
je null
.
index
nebo count
je záporné.
TextWriter je zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Tato metoda zapíše count
znaků dat do tohoto TextWriter
z pole znaků buffer
začínající na pozici index
.
Toto přetížení odpovídá přetížení Write(Char[]) pro každý znak v buffer
mezi index
a (index
+ count
).
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- soubor a streamování vstupně-výstupních
- Postupy: Čtení textu ze souboru
- Postupy: Zápis textu do souboru
Platí pro
Write(String, ReadOnlySpan<Object>)
Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>).
public:
virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);
abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))
Parametry
- format
- String
Složený formátovací řetězec.
- arg
- ReadOnlySpan<Object>
Rozsah objektu, který obsahuje nula nebo více objektů pro formátování a zápis.
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
Složený formátovací řetězec.
- 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
.
TextWriter je 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 je 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 ř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 o formátování:
Další informace o funkci složeného formátování naleznete v tématu složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce čí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ématu 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 naleznete v tématu Formát řetězců výčtu.
Další informace o formátování naleznete v tématu Typy formátování.
Parametr format
se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými 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[, délka][: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, naleznete 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 objekt určený indexem null , položka formátu se nahradí String.Empty. Protože toto přetížení má pole v seznamu parametrů, hodnota indexu index musí být vždy menší než délka pole. Pokud v pozici indexu neexistuje žádný parametr, vyvolá se FormatException. |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnaný doprava; pokud je záporná, je zarovnaná doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec podporovaný objektem, který má být formátován. Možné hodnoty formatString jsou stejné jako hodnoty podporované metodou ToString(string format) objektu. Pokud není zadán formatString a objekt, který se má formátovat, implementuje rozhraní IFormattable, null se předá jako hodnota parametru format , který se používá jako řetězec formátu IFormattable.ToString. |
Jsou vyžadovány počáteční a koncové znaky složené závorky {a }. Chcete-li v format
zadat jeden znak složené závorky literálu, zadejte dva počáteční nebo koncové znaky složené závorky; to znamená {{{ nebo "}}".
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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
Složený formátovací řetězec.
- arg0
- Object
Objekt pro formátování a zápis.
Výjimky
format
je null
.
TextWriter je 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 toto přetížení metody jedna).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na ř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 o formátování:
Další informace o funkci složeného formátování naleznete v tématu složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce čí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ématu 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 naleznete v tématu Formát řetězců výčtu.
Další informace o formátování naleznete v tématu Typy formátování.
Parametr format
se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými 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[, délka][: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, naleznete 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 objekt určený indexem null , položka formátu se nahradí String.Empty. Vzhledem k tomu, že toto přetížení má v seznamu parametrů pouze jeden objekt, hodnota indexu indexu musí být vždy 0. Pokud v pozici indexu neexistuje žádný parametr, vyvolá se FormatException. |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnaný doprava; pokud je záporná, je zarovnaná doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec podporovaný objektem, který má být formátován. Možné hodnoty formatString jsou stejné jako hodnoty podporované metodou ToString(string format) objektu. Pokud není zadán formatString a objekt, který se má formátovat, implementuje rozhraní IFormattable, null se předá jako hodnota parametru format , který se používá jako řetězec formátu IFormattable.ToString. |
Jsou vyžadovány počáteční a koncové znaky složené závorky {a }. Chcete-li v format
zadat jeden znak složené závorky literálu, zadejte dva počáteční nebo koncové znaky složené závorky; to znamená {{{ nebo "}}".
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 8bajtů 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
Celé číslo bez znaménka 8 bajtů, které se má zapisovat.
- Atributy
Výjimky
TextWriter je 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 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 4bajtů 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 k zápisu.
- Atributy
Výjimky
TextWriter je 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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ů pro zápis do textového streamu.
Poznámky
Tato metoda je ekvivalentní Write(stringBuilder.ToString())
, ale používá StringBuilder.GetChunks metodu, 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 k zápisu.
Výjimky
TextWriter je zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Toto přetížení odpovídá přetížení Write(Char[]).
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je TextWriter.NewLine.
Pokud je value
null
, nic se do textového streamu nepíše.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- Write(String)
- Write(String)
- soubor a streamování vstupně-výstupních
- 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 4bajtů 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
Hodnota 4 bajtu s plovoucí desetinou čárkou, která se má zapisovat.
Výjimky
TextWriter je 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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
Složený formátovací řetězec.
- 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
.
TextWriter je 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 toto přetížení metody dvě).
Poznámky
Tato metoda používá složené formátování k převodu hodnoty objektu na ř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 o formátování:
Další informace o funkci složeného formátování naleznete v tématu složené formátování.
Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce čí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ématu 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 naleznete v tématu Formát řetězců výčtu.
Další informace o formátování naleznete v tématu Typy formátování.
Parametr format
se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými 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[, délka][: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, naleznete 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 objekt určený indexem null , položka formátu se nahradí 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 neexistuje žádný parametr, vyvolá se FormatException. |
,délka | Minimální počet znaků v řetězcové reprezentaci parametru. Pokud je pozitivní, parametr je zarovnaný doprava; pokud je záporná, je zarovnaná doleva. |
:formatString | Standardní nebo vlastní formátovací řetězec podporovaný objektem, který má být formátován. Možné hodnoty formatString jsou stejné jako hodnoty podporované metodou ToString(string format) objektu. Pokud není zadán formatString a objekt, který se má formátovat, implementuje rozhraní IFormattable, null se předá jako hodnota parametru format , který se používá jako řetězec formátu IFormattable.ToString. |
Jsou vyžadovány počáteční a koncové znaky složené závorky {a }. Chcete-li v format
zadat jeden znak složené závorky literálu, zadejte dva počáteční nebo koncové znaky složené závorky; to znamená {{{ nebo "}}".
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je TextWriter.NewLine.
Pokud zadaný objekt není odkazován v řetězci formátu, bude ignorován.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 datového proudu voláním ToString
metody na daném objektu.
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, který se má zapsat.
Výjimky
TextWriter je zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Toto přetížení odpovídá přetížení Write(String).
Pokud je zadaný objekt null
, není provedena žádná akce a není vyvolána žádná výjimka. V opačném případě je volána ToString
objektu 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 textovou reprezentaci 8 bajtového celého čísla do textového streamu.
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
Celé číslo se 8 bajty, které se má zapisovat.
Výjimky
TextWriter je 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 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í úkoly.
Postupy: Zápis textu do souboru
Viz také
Platí pro
Write(Int32)
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
- Zdroj:
- TextWriter.cs
Zapíše textovou reprezentaci 4bajtů podepsaného celé číslo do textového streamu.
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
Celé číslo se 4 bajty, které se má zapisovat.
Výjimky
TextWriter je 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 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 textovou reprezentaci hodnoty s plovoucí desetinou čárkou 8 bajtů do textového datového proudu.
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 s plovoucí desetibínou čárkou 8 bajtů, která se má zapisovat.
Výjimky
TextWriter je 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 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í úkoly.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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 k zápisu.
Výjimky
TextWriter je zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Vlastnost FormatProvider, pokud není null
, určuje formátování specifické pro jazykovou verzi.
Viz také
- StreamWriter
- StringWriter
- IFormatProvider
- soubor a streamování vstupně-výstupních
- 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
TextWriter je zavřený.
Dojde k vstupně-výstupní chybě.
Poznámky
Tato metoda nehledává zadaný řetězec pro jednotlivé znaky nového řádku (šestnáctkové 0x000a) a nahradí je NewLine.
Tato výchozí metoda volá metodu Write(Char[], Int32, Int32) a předává celé pole znaků. Pokud je pole znaků null
, nic se nenapíše.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- Write(Char[])
- soubor a streamování vstupně-výstupních
- 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
TextWriter je 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 tak, aby poskytovala příslušné funkce.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- Write(Char)
- Write(Char)
- soubor a streamování vstupně-výstupních
- 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 reprezentaci hodnoty Boolean
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
k zápisu.
Výjimky
TextWriter je 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 výstupem je Boolean.TrueString nebo Boolean.FalseString.
Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.
Viz také
- StreamWriter
- StringWriter
- soubor a streamování vstupně-výstupních
- 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 znaků k zápisu.
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í úkoly.