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

Definition

Schreibt beim Überschreiben in einer abgeleiteten Klasse Text in jeweils einen Puffer. When overridden in a derived class, writes text one buffer at a time.

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. Character array containing the text to write.

index
Int32 Int32 Int32 Int32

Die Position innerhalb des Puffers, die den Anfang des zu schreibenden Texts kennzeichnet. The position in the buffer indicating the start of the text to write.

count
Int32 Int32 Int32 Int32

Die Anzahl der zu schreibenden Zeichen. The number of characters to write.

Ausnahmen

index oder count ist kleiner als 0. index or count is less than zero. - oder - -or- 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. The buffer length minus index is less than count; the call results in surrogate pair characters being split or an invalid surrogate pair being written.

Der buffer-Parameterwert ist ungültig. The buffer parameter value is not valid.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

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 Mengen an einen Puffer zu schreiben.This method can be used to write large amounts of text one buffer at a time.

Besondere Behandlung muss ausgeführt werden, um sicherzustellen, dass die WriteChars Methode teilt Ersatzzeichenpaare nicht auf mehrere.Special handling must be done to ensure the WriteChars method does not split surrogate pair characters across multiple buffer writes. Die XML-Spezifikation definiert die gültigen Bereiche für Ersatzzeichenpaare.The XML specification defines the valid ranges for surrogate pairs.

Die asynchrone Version dieser Methode finden Sie unter WriteCharsAsync.For the asynchronous version of this method, see WriteCharsAsync.

Gilt für: