StreamWriter.Write Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: System.IO.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje dane w strumieniu.

Przeciążenia

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

Write(String, Object, Object, Object)

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

Ciąg formatu złożonego.

arg0: Object

Pierwszy obiekt do formatu i zapis.

arg1: Object

Drugi obiekt do formatu 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.

Dotyczy

Write(String, Object, Object)

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

Ciąg formatu złożonego.

arg0: Object

Pierwszy obiekt do formatu i zapis.

arg1: Object

Drugi obiekt do formatu i zapisu.

Uwagi

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

Dotyczy

Write(Char[], Int32, Int32)

Zapisuje podarraj znaków do strumienia.

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

Pozycja znaku w buforze, w którym należy rozpocząć odczytywanie danych.

count: Int32

Maksymalna liczba znaków do zapisu.

Wyjątki

ArgumentNullException

buffer to null.

ArgumentException

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

ArgumentOutOfRangeException

index wartość lub count jest ujemna.

IOException

Wystąpi błąd We/Wy.

ObjectDisposedException

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący program zapisujący jest zamykany.

NotSupportedException

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

Przykłady

W tym przykładzie zapisuje osiem znaków z 13-elementowej tablicy 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 metodę TextWriter.Write .

Znaki są odczytywane od buffer początku i index kontynuowane przez znak + ( index - count 1). Wszystkie znaki są zapisywane w bazowym strumieniu, chyba że koniec bazowego strumienia zostanie osiągnięty przedwcześnie. Flush Jest wywoływana automatycznie, jeśli AutoFlush jest true .

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

Zobacz też

Dotyczy

Write(String, Object[])

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

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.

Dotyczy

Write(Char[])

Zapisuje tablicę znaków do strumienia.

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

Tablica znaków zawierająca dane do zapisu. Jeśli buffer to , nic nie jest null zapisywane.

Wyjątki

IOException

Wystąpi błąd We/Wy.

ObjectDisposedException

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący program zapisujący jest zamykany.

NotSupportedException

Uwagi

Ta metoda zastępuje metodę TextWriter.Write .

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

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

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

Zobacz też

Dotyczy

Write(String)

Zapisuje ciąg w strumieniu.

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

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

Wyjątki

ObjectDisposedException

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący program zapisujący jest zamykany.

NotSupportedException

IOException

Wystąpi błąd We/Wy.

Uwagi

Ta metoda zastępuje metodę TextWriter.Write .

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

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

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

Zobacz też

Dotyczy

Write(ReadOnlySpan<Char>)

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.

Dotyczy

Write(Char)

Zapisuje znak do strumienia.

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ąpi błąd We/Wy.

ObjectDisposedException

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący program zapisujący jest zamykany.

NotSupportedException

Uwagi

Ta metoda zastępuje metodę TextWriter.Write .

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

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

Zobacz też

Dotyczy

Write(String, Object)

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

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.

Dotyczy

StreamWriter.Write Metoda

Definicja

Przeciążenia

Write(String, Object, Object, Object)

Parametry

Uwagi

Dotyczy

Write(String, Object, Object)

Parametry

Uwagi

Dotyczy

Write(Char[], Int32, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Write(String, Object[])

Parametry

Uwagi

Dotyczy

Write(Char[])

Parametry

Wyjątki

Uwagi

Zobacz też

Dotyczy

Write(String)

Parametry

Wyjątki

Uwagi

Zobacz też

Dotyczy

Write(ReadOnlySpan<Char>)

Parametry

Dotyczy

Write(Char)

Parametry

Wyjątki

Uwagi

Zobacz też

Dotyczy

Write(String, Object)

Parametry

Uwagi

Dotyczy

Dodatkowe zasoby