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)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

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

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object).Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

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

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object[]).Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

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

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

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)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).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)

Параметры

format
String String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Первый объект для форматирования и записи.The first object to format and write.

arg1
Object Object Object Object

Второй объект для форматирования и записи.The second object to format and write.

arg2
Object Object Object Object

Третий объект для форматирования и записи.The third object to format and write.

Комментарии

Описание Write(String, Object, Object, Object) доступных возможностей составного форматирования см. в разделе.See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

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

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object).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)

Параметры

format
String String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Первый объект для форматирования и записи.The first object to format and write.

arg1
Object Object Object Object

Второй объект для форматирования и записи.The second object to format and write.

Комментарии

Описание Write(String, Object, Object) доступных возможностей составного форматирования см. в разделе.See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

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.

Исключения

Свойство buffer имеет значение null.buffer is null.

Длина буфера минус 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.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[])

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object[]).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())

Параметры

format
String String String String

Строка составного формата.A composite format string.

arg
Object[]

Массив объектов, содержащий от нуля и более объектов, которые необходимо форматировать и записать.An object array that contains zero or more objects to format and write.

Комментарии

Описание Write(String, Object[]) доступных возможностей составного форматирования см. в разделе.See Write(String, Object[]) for a description of the composite formatting capabilities offered.

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

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

Параметры

buffer
ReadOnlySpan<Char>

Записываемый диапазон символов.The character span to write.

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. Если AutoFlush имеет trueзначение ,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. Если AutoFlush имеет trueзначение ,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)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object).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)

Параметры

format
String String String String

Строка составного формата.A composite format string.

arg0
Object Object Object Object

Объект для форматирования и записи.The object to format and write.

Комментарии

Описание Write(String, Object) доступных возможностей составного форматирования см. в разделе.See Write(String, Object) for a description of the composite formatting capabilities offered.

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