StreamWriter.Write Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Сборка:

netstandard.dll

Сборка:

System.Runtime.Extensions.dll

Сборка:

System.IO.dll

Сборка:

mscorlib.dll

Записывает данные в поток.

Перегрузки

Write(String, Object, Object, Object)	Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).
Write(String, Object, Object)	Записывает отформатированную строку в поток, используя ту же семантику, что и Format(String, Object, Object) метод.
Write(Char[], Int32, Int32)	Записывает в поток дочерний массив символов.
Write(String, Object[])	Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object[]).
Write(Char[])	Записывает в поток массив символов.
Write(String)	Записывает в поток строку.
Write(ReadOnlySpan<Char>)	Записывает диапазон символов в поток.
Write(Char)	Записывает символ в поток.
Write(String, Object)	Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object).

Write(String, Object, Object, Object)

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

Параметры

format

String

Строка составного формата.

arg0

Object

Первый объект для форматирования и записи.

arg1

Object

Второй объект для форматирования и записи.

arg2

Object

Третий объект для форматирования и записи.

Комментарии

Write(String, Object, Object, Object)Описание доступных возможностей составного форматирования см. в разделе.

Write(String, Object, Object)

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

Параметры

format

String

Строка составного формата.

arg0

Object

Первый объект для форматирования и записи.

arg1

Object

Второй объект для форматирования и записи.

Комментарии

Write(String, Object, Object)Описание доступных возможностей составного форматирования см. в разделе.

Write(Char[], Int32, Int32)

Записывает в поток дочерний массив символов.

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

Массив символов, содержащий записываемые данные.

index

Int32

Положение символа в буфере, с которого начинается чтение данных.

count

Int32

Наибольшее количество символов для записи.

Исключения

ArgumentNullException

buffer имеет значение null.

ArgumentException

Длина буфера минус index меньше count.

ArgumentOutOfRangeException

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

IOException

Ошибка ввода-вывода.

ObjectDisposedException

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.

NotSupportedException

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

Примеры

Этот пример записывает восемь символов из 13-элементного массива в файл, начиная с третьего элемента массива.

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.

Символы считываются с buffer начала index и продолжаются через index + ( count -1). Все символы записываются в базовый поток, если только конец базового потока не достигнут преждевременно. Flush вызывается автоматически, если AutoFlush имеет значение true .

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String, Object[])

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

Параметры

format

String

Строка составного формата.

arg

Object[]

Массив объектов, содержащий от нуля и более объектов, которые необходимо форматировать и записать.

Комментарии

Write(String, Object[])Описание доступных возможностей составного форматирования см. в разделе.

Write(Char[])

Записывает в поток массив символов.

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

Параметры

buffer

Char[]

Массив символов, содержащий записываемые в поток данные. Если buffer имеет значение null, запись не выполняется.

Исключения

IOException

Ошибка ввода-вывода.

ObjectDisposedException

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.

NotSupportedException

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

Комментарии

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

Указанные символы записываются в базовый поток, если только конец потока не достигнут преждевременно. Если AutoFlush имеет значение true , Flush вызывается автоматически.

Этот метод может обеспечить более высокую производительность Write , чем ( char[],``int,``int ), так как в нем меньше аргументов для проверки.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String)

Записывает в поток строку.

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)

Параметры

value

String

Строка, записываемая в поток. Если value равняется null, запись не выполняется.

Исключения

ObjectDisposedException

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.

NotSupportedException

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

IOException

Ошибка ввода-вывода.

Комментарии

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

Указанный объект String записывается в базовый поток, если только конец потока не достигнут преждевременно.

Flush вызывается автоматически, если AutoFlush имеет значение true . Если value имеет значение null , записи не записываются.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

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

Записывает символ в поток.

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

Символ, записываемый в поток.

Исключения

IOException

Ошибка ввода-вывода.

ObjectDisposedException

AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.

NotSupportedException

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

Комментарии

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

Указанный символ записывается в базовый поток, если только конец потока не достигнут преждевременно. Если AutoFlush имеет значение true , Flush вызывается автоматически.

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Write(String, Object)

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

Параметры

format

String

Строка составного формата.

arg0

Object

Объект для форматирования и записи.

Комментарии

Write(String, Object)Описание доступных возможностей составного форматирования см. в разделе.