StringWriter::Write Method (array<Char>^, Int32, Int32)

.NET Framework (current version)

Writes a subarray of characters to the string.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
virtual void Write(
	array<wchar_t>^ buffer,
	int index,
	int count
) override

Parameters

buffer: Type: array<System::Char>^
The character array to write data from.

index: Type: System::Int32
The position in the buffer at which to start reading data.

count: Type: System::Int32
The maximum number of characters to write.

Exceptions

Exception	Condition
ArgumentNullException	buffer is null.
ArgumentOutOfRangeException	index or count is negative.
ArgumentException	(index + count)> buffer. Length.
ObjectDisposedException	The writer is closed.

Remarks

This method overrides TextWriter::Write.

This method writes count characters of data to this StringWriter from buffer, starting at position index.

The following table lists examples of other typical or related I/O tasks.

To do this...	See the example in this topic...
Create a text file.	How to: Write Text to a File
Write to a text file.	How to: Write Text to a File
Read from a text file.	How to: Read Text from a File
Append text to a file.	How to: Open and Append to a Log File File::AppendText FileInfo::AppendText
Get the size of a file.	FileInfo::Length
Get the attributes of a file.	File::GetAttributes
Set the attributes of a file.	File::SetAttributes
Determine if a file exists.	File::Exists
Read from a binary file.	How to: Read and Write to a Newly Created Data File
Write to a binary file.	How to: Read and Write to a Newly Created Data File

Examples

This code example is part of a larger example provided for the StringWriter() constructor.

C++

// 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( "." ) );

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1