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 podadresu znaků.
Write(String, Object[])	Zapíše formátovaný řetězec do datového proudu pomocí stejné sémantiky jako Format(String, Object[]) metoda.
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 pole 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, který se má formátovat a zapisovat.

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

Projděte si Write(String, Object, Object, Object) popis nabízených možností složeného formátování.

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, který se má formátovat a zapisovat.

arg1

Object

Druhý objekt pro formátování a zápis.

Poznámky

Projděte si Write(String, Object, Object) popis nabízených možností složeného formátování.

Write(Char[], Int32, Int32)

Zdroj:

StreamWriter.cs

Zapíše do datového proudu podadresu 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, na 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 minus index je menší než count.

ArgumentOutOfRangeException

index nebo count je negativní.

IOException

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

ObjectDisposedException

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

NotSupportedException

AutoFlush má hodnotu true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapsat do 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 13 elementů 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 od index a pokračování až do 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 se vyvolá automaticky, 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

Projděte si Write(String, Object[]) popis nabízených možností složeného formátování.

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

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

NotSupportedException

AutoFlush má hodnotu true nebo StreamWriter je vyrovnávací paměť plná a obsah vyrovnávací paměti nelze zapsat do 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 vyvolá automaticky, pokud AutoFlush je true. Pokud value je null, nejsou zapsány žá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(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 je true nebo StreamWriter je vyrovnávací paměť plná a aktuální zapisovač je zavřený.

NotSupportedException

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

Tato metoda může poskytovat vyšší 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(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, který se má zapisovat do datového proudu.

Výjimky

IOException

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

ObjectDisposedException

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

NotSupportedException

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

Poznámky

Projděte si Write(String, Object) popis nabízených možností složeného formátování.