StreamWriter.Write Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
System.IO.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.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, 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

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

Исключения

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

Исключения

ObjectDisposedException

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

NotSupportedException

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

IOException

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

Комментарии

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

Исключения

IOException

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

ObjectDisposedException

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

NotSupportedException

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

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

Исключения

IOException

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

ObjectDisposedException

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

NotSupportedException

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

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