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, 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, 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 вызывается автоматически, если 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(String, 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
, запись не выполняется.
Исключения
Ошибка ввода-вывода.
AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.
AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.
Комментарии
Этот метод переопределяет метод TextWriter.Write.
Указанные символы записываются в базовый поток, если только конец потока не достигается преждевременно. Если 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, запись не выполняется.
Исключения
AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.
AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.
Ошибка ввода-вывода.
Комментарии
Этот метод переопределяет метод TextWriter.Write.
Указанный String объект записывается в базовый поток, если только конец потока не будет достигнут преждевременно.
Flush вызывается автоматически, если AutoFlush имеет значение true
. Если value
имеет значение null
, записи не записываются.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
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
Символ, записываемый в поток.
Исключения
Ошибка ввода-вывода.
AutoFlush имеет значение True, или буфер StreamWriter полон, и текущее средство записи закрывается.
AutoFlush имеет значение True, или буфер StreamWriter полон, и его содержимое не может быть записано в основной поток заданного размера, поскольку StreamWriter находится в конце потока.
Комментарии
Этот метод переопределяет метод TextWriter.Write.
Указанный символ записывается в базовый поток, если конец потока не достигается преждевременно. Если AutoFlush имеет значение true
, 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) . в этой статье.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по