Parameters

buffer

Character array containing the text to write.

index

The position in the buffer indicating the start of the text to write.

count

The number of characters to write.

Exceptions

Type	Reason
ArgumentNullException	buffer is null.
ArgumentOutOfRangeException	index or count is less than zero. - or - The buffer length minus index is less than count.
InvalidOperationException	The XmlTextWriter.WriteState is WriteState.Closed.

Remarks

Note:

In the dnprdnext release, the recommended practice is to create System.Xml.XmlWriter instances using the erload:System.Xml.XmlWriter.Create method and the System.Xml.XmlWriterSettings class. This allows you to take full advantage of all the new features introduced in this release. For more information, see Creating XML Writers.

This method can be used to write large amounts of text one buffer at a time.

Special handling must be done to ensure the WriteChars method does not split surrogate pair characters across multiple buffer writes. The XML specification defines the valid ranges for surrogate pairs.

An exception is thrown if surrogate pair characters are written that would result in the surrogate pair characters being split in the buffer.

Requirements