StreamWriter.Write Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: System.IO.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 datového proudu.

Přetížení

Write(String, Object, Object, Object)	Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object, Object, Object).
Write(String, Object, Object)	Zapíše formátovaný řetězec do datového proudu pomocí stejné sémantiky jako Format(String, Object, Object) metoda.
Write(Char[], Int32, Int32)	Zapíše dílčí pole znaků do datového proudu.
Write(String, ReadOnlySpan<Object>)	Zapíše formátovaný řetězec do datového proudu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object[]).
Write(ReadOnlySpan<Char>)	Zapíše rozsah znaků do datového proudu.
Write(String)	Zapíše řetězec do datového proudu.
Write(Char[])	Zapíše do datového proudu pole znaků.
Write(Char)	Zapíše znak do datového proudu.
Write(String, Object)	Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object).

Write(String, Object, Object, Object)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object, Object, Object).

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

public override void Write (string format, object? arg0, object? arg1, object? arg2);

override this.Write : string * obj * obj * obj -> unit

Public Overrides 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.

Poznámky

Popis nabízených funkcí složeného formátování najdete v Write(String, Object, Object, Object).

Platí pro

Write(String, Object, Object)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše formátovaný řetězec do datového proudu pomocí stejné sémantiky jako Format(String, Object, Object) metoda.

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

public override void Write (string format, object? arg0, object? arg1);

override this.Write : string * obj * obj -> unit

Public Overrides 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.

Poznámky

Popis nabízených funkcí složeného formátování najdete v Write(String, Object, Object).

Platí pro

Write(Char[], Int32, Int32)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše dílčí pole znaků do datového proudu.

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);

public override void Write (char[] buffer, int index, int count);

override this.Write : char[] * int * int -> unit

Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

Parametry

buffer: Char[]

Pole znaků, které obsahuje data k zápisu.

index: Int32

Pozice znaku ve vyrovnávací paměti, na které se mají začít číst data.

count: Int32

Maximální počet znaků k zápisu.

Výjimky

ArgumentNullException

buffer je null.

ArgumentException

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

ArgumentOutOfRangeException

index nebo count je záporné.

IOException

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

ObjectDisposedException

AutoFlush je true nebo je StreamWriter vyrovnávací paměť plná a aktuální zapisovač je zavřený.

NotSupportedException

AutoFlush je pravdivá nebo je vyrovnávací paměť StreamWriter plná a obsah vyrovnávací paměti nelze zapsat do podkladového datového proudu s pevnou velikostí, protože StreamWriter je na konci datového proudu.

Příklady

Tento příklad zapíše do souboru osm znaků z pole s 13 prvky počínaje třetím prvkem pole.

using namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}

using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}

Imports System.IO

Public Class SWBuff

    Public Shared Sub Main()
        Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
        Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
           "h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
        Dim sw As New StreamWriter(sb)
        sw.Write(b, 3, 8)
        sw.Close()
    End Sub
End Class

Poznámky

Tato metoda přepíše TextWriter.Write.

Znaky se čtou z buffer počínaje index a procházejí index + (count - 1). Všechny znaky se zapisují do podkladového datového proudu, pokud není předčasně dosaženo konce podkladového datového proudu. Flush je vyvolána automaticky, pokud je AutoFlushtrue.

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

Viz také

Platí pro

Write(String, ReadOnlySpan<Object>)

Zapíše formátovaný řetězec do datového proudu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>).

public:
 override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public override void Write (string format, scoped ReadOnlySpan<object?> arg);

override this.Write : string * ReadOnlySpan<obj> -> unit

Public Overrides 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:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object[]).

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

public override void Write (string format, params object?[] arg);

override this.Write : string * obj[] -> unit

Public Overrides 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.

Poznámky

Popis nabízených funkcí složeného formátování najdete v Write(String, Object[]).

Platí pro

Write(ReadOnlySpan<Char>)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše rozsah znaků do datového proudu.

public:
 override void Write(ReadOnlySpan<char> buffer);

public override void Write (ReadOnlySpan<char> buffer);

override this.Write : ReadOnlySpan<char> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))

Parametry

buffer: ReadOnlySpan<Char>

Rozsah znaků k zápisu.

Platí pro

Write(String)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše řetězec do datového proudu.

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

public override void Write (string value);

public override void Write (string? value);

override this.Write : string -> unit

Public Overrides Sub Write (value As String)

Parametry

value: String

Řetězec pro zápis do datového proudu. Pokud value má hodnotu null, nic se nezapíše.

Výjimky

ObjectDisposedException

AutoFlush je true nebo je StreamWriter vyrovnávací paměť plná a aktuální zapisovač je zavřený.

NotSupportedException

IOException

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

Poznámky

Tato metoda přepíše TextWriter.Write.

Zadaná String se zapíše do podkladového datového proudu, pokud nedojde k předčasnému dosažení konce datového proudu.

Flush je vyvolána automaticky, pokud je AutoFlushtrue. Pokud je valuenull, nejsou zapsány žádné položky.

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

Viz také

Platí pro

Write(Char[])

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše do datového proudu pole znaků.

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

public override void Write (char[] buffer);

public override void Write (char[]? buffer);

override this.Write : char[] -> unit

Public Overrides Sub Write (buffer As Char())

Parametry

buffer: Char[]

Pole znaků obsahující data k zápisu. Pokud je buffernull, nic se nenapíše.

Výjimky

IOException

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

ObjectDisposedException

AutoFlush je true nebo je StreamWriter vyrovnávací paměť plná a aktuální zapisovač je zavřený.

NotSupportedException

Poznámky

Tato metoda přepíše TextWriter.Write.

Zadané znaky se zapisují do podkladového datového proudu, pokud nedojde k předčasnému dosažení konce datového proudu. Pokud je AutoFlushtrue, Flush se vyvolá automaticky.

Tato metoda může poskytovat rychlejší výkon než Write (char[],``int,``int), protože má méně argumentů ke kontrole.

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

Viz také

Platí pro

Write(Char)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše znak do datového proudu.

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

Parametry

value: Char

Znak pro zápis do datového proudu.

Výjimky

IOException

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

ObjectDisposedException

AutoFlush je true nebo je StreamWriter vyrovnávací paměť plná a aktuální zapisovač je zavřený.

NotSupportedException

Poznámky

Tato metoda přepíše TextWriter.Write.

Zadaný znak je zapsán do podkladového datového proudu, pokud není předčasně dosaženo konce datového proudu. Pokud je AutoFlushtrue, Flush se vyvolá automaticky.

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

Viz také

Platí pro

Write(String, Object)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zapíše do datového proudu formátovaný řetězec se stejnou sémantikou jako metoda Format(String, Object).

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

public override void Write (string format, object? arg0);

override this.Write : string * obj -> unit

Public Overrides 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.

Poznámky

Popis nabízených funkcí složeného formátování najdete v Write(String, Object).

Platí pro

Sdílet prostřednictvím

StreamWriter.Write Metoda

Definice

Přetížení

Write(String, Object, Object, Object)

Parametry

Poznámky

Platí pro

Write(String, Object, Object)

Parametry

Poznámky

Platí pro

Write(Char[], Int32, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Write(String, ReadOnlySpan<Object>)

Parametry

Platí pro

Write(String, Object[])

Parametry

Poznámky

Platí pro

Write(ReadOnlySpan<Char>)

Parametry

Platí pro

Write(String)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

Write(Char[])

Parametry

Výjimky

Poznámky

Viz také

Platí pro

Write(Char)

Parametry

Výjimky

Poznámky

Viz také

Platí pro

Write(String, Object)

Parametry

Poznámky

Platí pro

Další materiály