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

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Schreibt beim Überschreiben in einer abgeleiteten Klasse Text in jeweils einen Puffer.

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

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

abstract member WriteChars : char[] * int * int -> unit

Public MustOverride 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.

ArgumentException

Der buffer-Parameterwert ist ungültig.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

using (XmlWriter writer = XmlWriter.Create("WriteChars.xml"))
{
    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

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

Es muss eine spezielle Behandlung durchgeführt werden, um sicherzustellen, dass die WriteChars Methode keine Ersatzpaarzeichen auf mehrere Pufferschreibvorgänge aufteilt. Die XML-Spezifikation definiert die gültigen Bereiche für Ersatzzeichenpaare.

Die asynchrone Version dieser Methode finden Sie unter WriteCharsAsync.