StreamWriter.Write Metoda

Definicja

Zapisuje dane w strumieniu.Writes data to the stream.

Przeciążenia

Write(String, Object, Object, Object)

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object, Object, Object) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object, Object)

Zapisuje sformatowany ciąg do strumienia przy użyciu tej samej semantyki co Format(String, Object, Object) Metoda.Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

Write(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia.Writes a subarray of characters to the stream.

Write(String, Object[])

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object[]) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków w strumieniu.Writes a character span to the stream.

Write(String)

Zapisuje ciąg w strumieniu.Writes a string to the stream.

Write(Char[])

Zapisuje tablicę znaków w strumieniu.Writes a character array to the stream.

Write(Char)

Zapisuje znak w strumieniu.Writes a character to the stream.

Write(String, Object)

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object, Object)

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object, Object, Object) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

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.A composite format string.

arg0
Object

Pierwszy obiekt do formatu i zapis.The first object to format and write.

arg1
Object

Drugi obiekt do formatu i zapisu.The second object to format and write.

arg2
Object

Trzeci obiekt do formatowania i zapisu.The third object to format and write.

Uwagi

Zobacz Write(String, Object, Object, Object) , aby uzyskać opis oferowanych funkcji formatowania złożonego.See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

Dotyczy

Write(String, Object, Object)

Zapisuje sformatowany ciąg do strumienia przy użyciu tej samej semantyki co Format(String, Object, Object) Metoda.Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

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.A composite format string.

arg0
Object

Pierwszy obiekt do formatu i zapis.The first object to format and write.

arg1
Object

Drugi obiekt do formatu i zapisu.The second object to format and write.

Uwagi

Zobacz Write(String, Object, Object) , aby uzyskać opis oferowanych funkcji formatowania złożonego.See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

Dotyczy

Write(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia.Writes a subarray of characters to the stream.

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, która zawiera dane do zapisu.A character array that contains the data to write.

index
Int32

Pozycja znaku w buforze, od którego ma zostać rozpoczęte odczytywanie danych.The character position in the buffer at which to start reading data.

count
Int32

Maksymalna liczba znaków do zapisania.The maximum number of characters to write.

Wyjątki

buffer to null.buffer is null.

Długość buforu minus index jest mniejsza niż count .The buffer length minus index is less than count.

index lub count jest ujemna.index or count is negative.

Wystąpi błąd We/Wy.An I/O error occurs.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący składnik zapisywania jest zamknięty.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny i zawartość buforu nie może zostać zapisywana w strumieniu o ustalonym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Przykłady

Ten przykład zapisuje osiem znaków z 13-elementowych tablic do pliku, zaczynając od trzeciego elementu tablicy.This example writes eight characters from a 13-element array to a file, beginning at the third element of the array.

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 przesłania TextWriter.Write .This method overrides TextWriter.Write.

Znaki są odczytywane od buffer początku i w czasie index do index + ( count -1).The characters are read from buffer beginning at index and continuing through index + (count - 1). Wszystkie znaki są zapisywane w strumieniu źródłowym, chyba że koniec strumienia bazowego zostanie przedwcześnie osiągnięty.All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. Flush jest wywoływana automatycznie, jeśli AutoFlush jest true .Flush is invoked automatically if AutoFlush is true.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy

Write(String, Object[])

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object[]) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

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.A composite format string.

arg
Object[]

Tablica obiektów, która zawiera zero lub więcej obiektów do formatowania i zapisu.An object array that contains zero or more objects to format and write.

Uwagi

Zobacz Write(String, Object[]) , aby uzyskać opis oferowanych funkcji formatowania złożonego.See Write(String, Object[]) for a description of the composite formatting capabilities offered.

Dotyczy

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków w strumieniu.Writes a character span to the stream.

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 zapisania.The character span to write.

Dotyczy

Write(String)

Zapisuje ciąg w strumieniu.Writes a string to the stream.

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.The string to write to the stream. Jeśli value ma wartość null, nic nie jest zapisywana.If value is null, nothing is written.

Wyjątki

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący składnik zapisywania jest zamknięty.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny i zawartość buforu nie może zostać zapisywana w strumieniu o ustalonym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Ta metoda przesłania TextWriter.Write .This method overrides TextWriter.Write.

Określony obiekt String jest zapisywana w strumieniu źródłowym, chyba że koniec strumienia zostanie przedwcześnie osiągnięty.The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

Flush jest wywoływana automatycznie, jeśli AutoFlush jest true .Flush is invoked automatically if AutoFlush is true. Jeśli value jest null , żadne wpisy nie są zapisywane.If value is null, no entries are written.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy

Write(Char[])

Zapisuje tablicę znaków w strumieniu.Writes a character array to the stream.

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.A character array containing the data to write. Jeśli buffer jest null , nic nie jest zapisywana.If buffer is null, nothing is written.

Wyjątki

Wystąpi błąd We/Wy.An I/O error occurs.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący składnik zapisywania jest zamknięty.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny i zawartość buforu nie może zostać zapisywana w strumieniu o ustalonym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Uwagi

Ta metoda przesłania TextWriter.Write .This method overrides TextWriter.Write.

Określone znaki są zapisywane w strumieniu źródłowym, chyba że koniec strumienia zostanie przedwcześnie osiągnięty.The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. Jeśli AutoFlush jest true , Flush jest wywoływana automatycznie.If AutoFlush is true, Flush is invoked automatically.

Ta metoda może zapewnić lepszą wydajność niż Write ( char[],``int,``int ), ponieważ ma mniejszą liczbę argumentów do sprawdzenia.This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy

Write(Char)

Zapisuje znak w strumieniu.Writes a character to the stream.

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.The character to write to the stream.

Wyjątki

Wystąpi błąd We/Wy.An I/O error occurs.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny, a bieżący składnik zapisywania jest zamknięty.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush ma wartość true lub StreamWriter bufor jest pełny i zawartość buforu nie może zostać zapisywana w strumieniu o ustalonym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Uwagi

Ta metoda przesłania TextWriter.Write .This method overrides TextWriter.Write.

Określony znak jest zapisywana w strumieniu źródłowym, chyba że koniec strumienia zostanie przedwcześnie osiągnięty.The specified character is written to the underlying stream unless the end of the stream is reached prematurely. Jeśli AutoFlush jest true , Flush jest wywoływana automatycznie.If AutoFlush is true, Flush is invoked automatically.

Aby uzyskać listę typowych zadań we/wy, zobacz typowe zadania we/wy.For a list of common I/O tasks, see Common I/O Tasks.

Dotyczy

Write(String, Object)

Zapisuje sformatowany ciąg do strumienia, używając tej samej semantyki co Format(String, Object) Metoda.Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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.A composite format string.

arg0
Object

Obiekt do formatowania i zapisu.The object to format and write.

Uwagi

Zobacz Write(String, Object) , aby uzyskać opis oferowanych funkcji formatowania złożonego.See Write(String, Object) for a description of the composite formatting capabilities offered.

Dotyczy