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

Definition

Namespace:
System.Xml
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Schreibt Text 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 im Puffer, die den Anfang des zu schreibenden Texts angibt.

count
Int32

Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist kleiner als Null.

-oder-

Die Pufferlänge minus index ist kleiner als count; der Aufruf führt dazu, dass Ersatzpaarzeichen geteilt oder ein ungültiges Ersatzpaar geschrieben wird.

InvalidOperationException

Dies WriteState ist geschlossen.

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

Note

Wir empfehlen Ihnen, XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellen, um von neuen Funktionen zu profitieren.

Diese Methode kann zum gleichzeitigen Schreiben großer Textmengen verwendet werden.

Eine spezielle Behandlung muss durchgeführt werden, um sicherzustellen, dass die WriteChars Methode keine Ersatzpaarzeichen über mehrere Pufferschreibvorgänge verteilt. Die XML-Spezifikation definiert die gültigen Bereiche für Ersatzpaare.

Eine Ausnahme wird ausgelöst, wenn Ersatzpaarzeichen geschrieben werden, die dazu führen würden, dass die Ersatzpaarzeichen im Puffer aufgeteilt werden.

Gilt für: