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

Исходный код:: 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(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

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

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

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

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

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

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

Исключения

IOException

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

ObjectDisposedException

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

NotSupportedException

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

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

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

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

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

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

IOException

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

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

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

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

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

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

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

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

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

StreamWriter.Write Метод

Определение

Перегрузки

Write(String, Object, Object, Object)

Параметры

Комментарии

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

Write(String, Object, Object)

Параметры

Комментарии

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

Write(Char[], Int32, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

Write(String, Object[])

Параметры

Комментарии

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

Write(Char[])

Параметры

Исключения

Комментарии

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

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

Write(String)

Параметры

Исключения

Комментарии

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

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

Write(ReadOnlySpan<Char>)

Параметры

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

Write(Char)

Параметры

Исключения

Комментарии

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

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

Write(String, Object)

Параметры

Комментарии

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

Обратная связь

Дополнительные ресурсы