StringWriter.Write Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

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

Перегрузки

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

Write(Char[], Int32, Int32)

Исходный код:

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

ArgumentOutOfRangeException

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

ArgumentException

(index + count)>buffer. Length.

ObjectDisposedException

Модуль записи закрыт.

Примеры

Этот пример кода является частью более крупного примера, предоставленного для конструктора StringWriter() .

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Комментарии

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

Этот метод записывает символы count данных StringWriter из , начиная с bufferпозиции index.

В следующей таблице перечислены примеры других типичных или связанных задач ввода-вывода.

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных File.AppendText FileInfo.AppendText
Получение размера файла.	FileInfo.Length
Получение атрибутов файла.	File.GetAttributes
Задайте атрибуты файла.	File.SetAttributes
Определите, существует ли файл.	File.Exists
Чтение из двоичного файла.	Практическое руководство. Считывание данных из нового файла и запись в этот файл
Запись в двоичный файл.	Практическое руководство. Считывание данных из нового файла и запись в этот файл

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

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

Write(String)

Исходный код:

StringWriter.cs

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

public:
 override void Write(System::String ^ value);

public override void Write (string? value);

override this.Write : string -> unit

Public Overrides Sub Write (value As String)

Параметры

value

String

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

Исключения

ObjectDisposedException

Модуль записи закрыт.

Примеры

Этот пример входит в состав более крупного примера использования класса StringWriter.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Комментарии

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

Если указанная строка имеет значение null, ничего не записывается.

В следующей таблице перечислены примеры других типичных или связанных задач ввода-вывода.

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных File.AppendText FileInfo.AppendText
Получение размера файла.	FileInfo.Length
Получение атрибутов файла.	File.GetAttributes
Задайте атрибуты файла.	File.SetAttributes
Определите, существует ли файл.	File.Exists
Чтение из двоичного файла.	Практическое руководство. Считывание данных из нового файла и запись в этот файл
Запись в двоичный файл.	Практическое руководство. Считывание данных из нового файла и запись в этот файл

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

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

Write(StringBuilder)

Исходный код:

StringWriter.cs

Записывает строковое представление построителя строки в текущую строку.

public:
 override void Write(System::Text::StringBuilder ^ value);

public override void Write (System.Text.StringBuilder? value);

override this.Write : System.Text.StringBuilder -> unit

Public Overrides Sub Write (value As StringBuilder)

Параметры

value

StringBuilder

Построитель строки для записи в поток.

Write(Char)

Исходный код:

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

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

Исключения

ObjectDisposedException

Модуль записи закрыт.

Примеры

Этот пример кода является частью более крупного примера, предоставленного для конструктора StringWriter() .

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Комментарии

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

В следующей таблице перечислены примеры других типичных или связанных задач ввода-вывода.

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных File.AppendText FileInfo.AppendText
Получение размера файла.	FileInfo.Length
Получение атрибутов файла.	File.GetAttributes
Задайте атрибуты файла.	File.SetAttributes
Определите, существует ли файл.	File.Exists
Чтение из двоичного файла.	Практическое руководство. Считывание данных из нового файла и запись в этот файл
Запись в двоичный файл.	Практическое руководство. Считывание данных из нового файла и запись в этот файл

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

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

Write(ReadOnlySpan<Char>)

Исходный код:

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

Диапазон символов для записи в строку.