StreamWriter.Write Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Zapisuje dane w strumieniu.

Przeciążenia

Write(String, Object, Object, Object)	Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object, Object).
Write(String, Object, Object)	Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object).
Write(Char[], Int32, Int32)	Zapisuje podarraj znaków w strumieniu.
Write(String, Object[])	Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object[]).
Write(ReadOnlySpan<Char>)	Zapisuje zakres znaków w strumieniu.
Write(String)	Zapisuje ciąg w strumieniu.
Write(Char[])	Zapisuje tablicę znaków w strumieniu.
Write(Char)	Zapisuje znak w strumieniu.
Write(String, Object)	Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object).

Write(String, Object, Object, Object)

Źródło:

StreamWriter.cs

Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co 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

Ciąg formatu złożonego.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

arg2

Object

Trzeci obiekt do formatowania i zapisu.

Uwagi

Zobacz Write(String, Object, Object, Object) opis oferowanych możliwości formatowania złożonego.

Write(String, Object, Object)

Źródło:

StreamWriter.cs

Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object).

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

Ciąg formatu złożonego.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

Uwagi

Zobacz Write(String, Object, Object) opis oferowanych możliwości formatowania złożonego.

Write(Char[], Int32, Int32)

Źródło:

StreamWriter.cs

Zapisuje podarraj znaków w strumieniu.

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

Tablica znaków zawierająca dane do zapisu.

index

Int32

Położenie znaku w buforze, w którym należy rozpocząć odczytywanie danych.

count

Int32

Maksymalna liczba znaków do zapisania.

Wyjątki

ArgumentNullException

buffer jest null.

ArgumentException

Długość buforu minus index jest mniejsza niż count.

ArgumentOutOfRangeException

index lub count jest ujemna.

IOException

Występuje błąd we/wy.

ObjectDisposedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.

NotSupportedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.

Przykłady

W tym przykładzie zapisuje osiem znaków z tablicy 13 elementów do pliku, zaczynając od trzeciego elementu tablicy.

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

Uwagi

Ta metoda zastępuje TextWriter.Write.

Znaki są odczytywane z buffer zaczynając od index i kontynuując index + (count - 1). Wszystkie znaki są zapisywane w strumieniu bazowym, chyba że koniec bazowego strumienia zostanie osiągnięty przedwcześnie. Flush jest wywoływany automatycznie, jeśli AutoFlush jest true.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(String, Object[])

Źródło:

StreamWriter.cs

Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co 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

Ciąg formatu złożonego.

arg

Object[]

Tablica obiektów zawierająca zero lub więcej obiektów do formatowania i zapisu.

Uwagi

Zobacz Write(String, Object[]) opis oferowanych możliwości formatowania złożonego.

Write(ReadOnlySpan<Char>)

Źródło:

StreamWriter.cs

Zapisuje zakres znaków w strumieniu.

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>

Zakres znaków do zapisu.

Write(String)

Źródło:

StreamWriter.cs

Zapisuje ciąg w strumieniu.

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

Ciąg do zapisu w strumieniu. Jeśli value ma wartość null, nic nie jest zapisywane.

Wyjątki

ObjectDisposedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.

NotSupportedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.

IOException

Występuje błąd we/wy.

Uwagi

Ta metoda zastępuje TextWriter.Write.

Określony String jest zapisywany do bazowego strumienia, chyba że koniec strumienia zostanie osiągnięty przedwcześnie.

Flush jest wywoływany automatycznie, jeśli AutoFlush jest true. Jeśli value jest null, nie są zapisywane żadne wpisy.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Char[])

Źródło:

StreamWriter.cs

Zapisuje tablicę znaków w strumieniu.

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

Tablica znaków zawierająca dane do zapisania. Jeśli buffer jest null, nic nie jest napisane.

Wyjątki

IOException

Występuje błąd we/wy.

ObjectDisposedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.

NotSupportedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.

Uwagi

Ta metoda zastępuje TextWriter.Write.

Określone znaki są zapisywane w strumieniu bazowym, chyba że koniec strumienia zostanie osiągnięty przedwcześnie. Jeśli AutoFlush jest true, Flush jest wywoływana automatycznie.

Ta metoda może zapewnić szybszą wydajność niż Write (char[],``int,``int), ponieważ ma mniej argumentów do sprawdzenia.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(Char)

Źródło:

StreamWriter.cs

Zapisuje znak w strumieniu.

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 do zapisu w strumieniu.

Wyjątki

IOException

Występuje błąd we/wy.

ObjectDisposedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.

NotSupportedException

AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.

Uwagi

Ta metoda zastępuje TextWriter.Write.

Określony znak jest zapisywany w strumieniu bazowym, chyba że koniec strumienia zostanie osiągnięty przedwcześnie. Jeśli AutoFlush jest true, Flush jest wywoływana automatycznie.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• plików i strumienia we/wy
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

Write(String, Object)

Źródło:

StreamWriter.cs

Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co 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

Ciąg formatu złożonego.

arg0

Object

Obiekt do formatowania i zapisu.

Uwagi

Zobacz Write(String, Object) opis oferowanych możliwości formatowania złożonego.