XmlTextWriter.WriteChars(Char[], Int32, Int32) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Schreibt Text in jeweils einen Puffer.

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)

Parameter

buffer

Char[]

Zeichenarray, das den zu schreibenden Text enthält.

index

Int32

Die Position innerhalb des Puffers, die den Anfang des zu schreibenden Texts kennzeichnet.

count

Int32

Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist kleiner als 0.

- oder - Die Länge des Puffers minus index ist kleiner als count. Der Aufruf führt zur Aufteilung eines Ersatzzeichenpaars oder zum Schreiben eines ungültigen Ersatzzeichenpaars.

InvalidOperationException

Der WriteState ist Closed.

Beispiele

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();
}

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der Methode und der XmlWriter.Create XmlWriterSettings Klasse zu erstellenXmlWriter, um neue Funktionen zu nutzen.

Diese Methode kann verwendet werden, um große Textmengen gleichzeitig zu schreiben.

Die spezielle Behandlung muss durchgeführt werden, um sicherzustellen, dass die WriteChars Methode keine Surrogate-Paarzeichen über mehrere Pufferschreibungen verteilt. Die XML-Spezifikation definiert die gültigen Bereiche für Surrogate-Paare.

Eine Ausnahme wird ausgelöst, wenn Surrogate-Paarzeichen geschrieben werden, die dazu führen würden, dass die Surrogate-Paarzeichen im Puffer geteilt werden.