StreamWriter.Write Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zapíše data do datového proudu.

Přetížení

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

Write(String, Object, Object, Object)

Zdroj:

StreamWriter.cs

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

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

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

Poznámky

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

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

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

Poznámky

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

Write(Char[], Int32, Int32)

Zdroj:

StreamWriter.cs

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

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, ve které se mají začít číst data.

count

Int32

Maximální počet znaků, které se mají napsat.

Výjimky

ArgumentNullException

buffer je null.

ArgumentException

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

ArgumentOutOfRangeException

index nebo count je negativní.

IOException

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

ObjectDisposedException

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

NotSupportedException

AutoFlush hodnota true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapisovat 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 osm znaků z pole se 13 prvky do souboru 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 od buffer začátku index a pokračování až do index + (count - 1). Všechny znaky jsou zapsány do podkladového datového proudu, pokud není předčasně dosaženo konce podkladového datového proudu. Flush se automaticky vyvolá, pokud AutoFlush je true.

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

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(String, Object[])

Zdroj:

StreamWriter.cs

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

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

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

Poznámky

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

Write(Char[])

Zdroj:

StreamWriter.cs

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

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 buffer je null, nic se nepíše.

Výjimky

IOException

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

ObjectDisposedException

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

NotSupportedException

AutoFlush hodnota true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapisovat 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 jsou zapsány do podkladového datového proudu, pokud není konce datového proudu dosaženo předčasně. Pokud AutoFlush je true, Flush vyvolá se 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í úlohy.

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

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 je hodnota null, nic se nezapíše.

Výjimky

ObjectDisposedException

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

NotSupportedException

AutoFlush hodnota true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapisovat 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 datový proud se zapíše do podkladového datového proudu, pokud není předčasně dosaženo konce datového proudu.

Flush se automaticky vyvolá, pokud AutoFlush je true. Pokud value je null, nezapíšou se žádné položky.

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

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

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ů, který se má psát.

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 hodnota true nebo StreamWriter vyrovnávací paměť je plná a aktuální zapisovač je zavřený.

NotSupportedException

AutoFlush hodnota true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapisovat 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í dosaženo konce datového proudu předčasně. Pokud AutoFlush je true, Flush vyvolá se automaticky.

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

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Write(String, Object)

Zdroj:

StreamWriter.cs

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

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

Řetězec složeného formátu.

arg0

Object

Objekt pro formátování a zápis.

Poznámky

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