TextWriter.Write Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.IO.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

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 `ToString` metody pro tento objekt.
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 `Boolean` hodnoty do textového streamu.
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

ArgumentNullException

format je null.

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

FormatException

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 formatzadat 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é

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

ArgumentException

Délka vyrovnávací paměti mínus index je menší než count.

ArgumentNullException

Parametr buffer je null.

ArgumentOutOfRangeException

index nebo count je negativní.

ObjectDisposedException

Je TextWriter zavřený.

IOException

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 indexbuffer a (index + count).

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

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

ArgumentNullException

format nebo arg je null.

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

FormatException

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]}

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é

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

ArgumentNullException

format je null.

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

FormatException

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

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

Syntaxe položky formátu je následující:

{index[,length][:formatString]}

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.

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é

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: CLSCompliantAttribute

Výjimky

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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: CLSCompliantAttribute

Výjimky

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ArgumentNullException

format je null.

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

FormatException

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

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

Syntaxe položky formátu je následující:

{index[,length][:formatString]}

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.

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

Poznámky

Toto přetížení je ekvivalentní Write(String) přetížení.

Pokud je nullzadaný 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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

Dojde k vstupně-výstupní chybě.

Poznámky

Vlastnost FormatProvider , pokud ne null, určuje formátování specifické pro jazykovou verzi.

Viz také

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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 nullpole 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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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

ObjectDisposedException

Je TextWriter zavřený.

IOException

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é

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