StreamWriter.Write Метод

Определение

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

Перегрузки

Write(String, Object, Object, Object)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object, Object).

Write(String, Object, Object)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object, Object).

Write(Char[], Int32, Int32)

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

Write(String, ReadOnlySpan<Object>)

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

Write(String, Object[])

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

Write(ReadOnlySpan<Char>)

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

Write(String)

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

Write(Char[])

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

Write(Char)

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

Write(String, Object)

Записывает форматированную строку в поток, используя ту же семантику, что и метод Format(String, Object).

Write(String, Object, Object, Object)

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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

Максимальное количество символов для записи.

Исключения

buffer null.

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

index или count отрицательно.

Возникает ошибка ввода-вывода.

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

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 вызывается автоматически, если AutoFlushtrue.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

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

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

Write(String, ReadOnlySpan<Object>)

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

public:
 override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))

Параметры

format
String

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

arg
ReadOnlySpan<Object>

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

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

Write(String, Object[])

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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)

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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, ничего не записывается.

Исключения

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

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

Возникает ошибка ввода-вывода.

Комментарии

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

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

Flush вызывается автоматически, если AutoFlushtrue. Если valuenull, записи не записываются.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

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

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

Write(Char[])

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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

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

Исключения

Возникает ошибка ввода-вывода.

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

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

Комментарии

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

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

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

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

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

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

Write(Char)

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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

Символ для записи в поток.

Исключения

Возникает ошибка ввода-вывода.

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

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

Комментарии

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

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

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

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

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

Write(String, Object)

Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs
Исходный код:
StreamWriter.cs

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

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