XmlTextWriter.WriteChars(Char[], Int32, Int32) 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

以每次一个缓冲区的方式写入文本。

public:
 override void WriteChars(cli::array <char> ^ buffer, int index, int count);

public override void WriteChars (char[] buffer, int index, int count);

override this.WriteChars : char[] * int * int -> unit

Public Overrides Sub WriteChars (buffer As Char(), index As Integer, count As Integer)

参数

buffer

Char[]

包含要写入的文本的字符数组。

index

Int32

缓冲区中指示要写入文本的起始位置的位置。

count

Int32

要写入的字符数。

例外

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

index 或 count 小于零。

• 或 - 缓冲区长度减去 index 小于 count；此调用导致代理项对字符被拆分或写入无效的代理项对。

InvalidOperationException

WriteState 为 Closed。

示例

using (XmlTextWriter writer = new XmlTextWriter(Console.Out))
{
    writer.WriteStartDocument();

    char[] ch = new char[4];
    ch[0] = 't';
    ch[1] = 'e';
    ch[2] = 'x';
    ch[3] = 't';

    writer.WriteStartElement("WriteCharacters");
    writer.WriteChars(ch, 0, ch.Length);
    writer.WriteEndElement();
    writer.WriteEndDocument();
}

注解

备注

从 .NET Framework 2.0 开始，我们建议使用XmlWriter.Create方法和XmlWriterSettings类来创建XmlWriter实例，以利用新功能。

此方法可用于一次写入大量文本。

必须执行特殊处理，以确保 WriteChars 该方法不会跨多个缓冲区写入拆分代理项对字符。 XML 规范定义代理项对的有效范围。

如果写入代理项对字符会导致代理项对字符在缓冲区中拆分，则会引发异常。