StreamWriter.Write Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

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, 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

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

Write(String, Object, Object)

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

Write(Char[], Int32, Int32)

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é

• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(String, Object[])

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[]).

Write(ReadOnlySpan<Char>)

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.

Write(String)

Zdroj:

StreamWriter.cs

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

public:
 override void Write(System::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

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.

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é

• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(Char[])

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);

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

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.

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é

• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(Char)

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

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.

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é

• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(String, Object)

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