StreamWriter.Write StreamWriter.Write StreamWriter.Write StreamWriter.Write Method

Определение

Записывает данные в поток.Writes data to the stream.

Перегрузки

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)
Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)
Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Записывает в поток дочерний массив символов.Writes a subarray of characters to the stream.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])
Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)
Write(String) Write(String) Write(String) Write(String)

Записывает в поток строку.Writes a string to the stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Записывает в поток массив символов.Writes a character array to the stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Записывает символ в поток.Writes a character to the stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(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)

Параметры

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(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)

Параметры

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Записывает в поток дочерний массив символов.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)

Параметры

buffer
Char[]

Массив символов, содержащий записываемые данные.A character array that contains the data to write.

index
Int32 Int32 Int32 Int32

Положение символа в буфере, с которого начинается чтение данных.The character position in the buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

Наибольшее количество символов для записи.The maximum number of characters to write.

Исключения

Длина буфера минус index меньше count.The buffer length minus index is less than count.

index или count является отрицательным значением.index or count is negative.

Ошибка ввода-вывода.An I/O error occurs.

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.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.

Примеры

Этот пример записывает восемь символов из 13 элементов массива в файл, начиная с третьего элемента массива.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
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

Комментарии

Этот метод переопределяет метод TextWriter.Write.This method overrides TextWriter.Write.

Символов считываются из buffer начиная index и заканчивая index + (count - 1).The characters are read from buffer beginning at index and continuing through index + (count - 1). Все символы записываются в основной поток, если достигнут конец основной поток.All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. Flush вызывается автоматически, если AutoFlush является true.Flush is invoked automatically if AutoFlush is true.

Список задач ввода-вывода, см. в разделе распространенные задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(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())

Параметры

arg
Object[]

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

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))

Параметры

buffer
ReadOnlySpan<Char>

Write(String) Write(String) Write(String) Write(String)

Записывает в поток строку.Writes a string to the stream.

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)

Параметры

value
String String String String

Строка, записываемая в поток.The string to write to the stream. Если value равняется null, запись не выполняется.If value is null, nothing is written.

Исключения

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.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.

Ошибка ввода-вывода.An I/O error occurs.

Комментарии

Этот метод переопределяет метод TextWriter.Write.This method overrides TextWriter.Write.

Указанный String записывается в основной поток, если достигнут конец потока.The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

Flush вызывается автоматически, если AutoFlush является true.Flush is invoked automatically if AutoFlush is true. Если value является null, запись не выполняется.If value is null, no entries are written.

Список задач ввода-вывода, см. в разделе распространенные задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Записывает в поток массив символов.Writes a character array to the stream.

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())

Параметры

buffer
Char[]

Массив символов, содержащий записываемые в поток данные.A character array containing the data to write. Если buffer имеет значение null, запись не выполняется.If buffer is null, nothing is written.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.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.

Комментарии

Этот метод переопределяет метод TextWriter.Write.This method overrides TextWriter.Write.

Указанные символы записываются в основной поток, если достигнут конец потока.The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. Если AutoFlushtrue, Flush будет вызываться автоматически.If AutoFlush is true, Flush is invoked automatically.

Этот метод может предоставить прироста производительности по сравнению Write (char[],``int,``int) так как она содержит меньшее число аргументов для проверки.This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

Список задач ввода-вывода, см. в разделе распространенные задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(Char) Write(Char) Write(Char) Write(Char)

Записывает символ в поток.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)

Параметры

value
Char Char Char Char

Символ, записываемый в поток.The character to write to the stream.

Исключения

Ошибка ввода-вывода.An I/O error occurs.

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.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.

Комментарии

Этот метод переопределяет метод TextWriter.Write.This method overrides TextWriter.Write.

Указанный символ записывается в основной поток, если достигнут конец потока.The specified character is written to the underlying stream unless the end of the stream is reached prematurely. Если AutoFlushtrue, Flush будет вызываться автоматически.If AutoFlush is true, Flush is invoked automatically.

Список задач ввода-вывода, см. в разделе распространенные задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Дополнительно

Write(String, Object) Write(String, Object) Write(String, Object) Write(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)

Параметры

Применяется к