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

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlWriter.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird jeweils ein Puffer geschrieben.

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

ArgumentException

Der Wert für Parameter buffer ist ungültig.

InvalidOperationException

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 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.

Die asynchrone Version dieser Methode finden Sie unter WriteCharsAsync.