XmlWriter.WriteChars-Methode

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

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public MustOverride Sub WriteChars ( _
    buffer As Char(), _
    index As Integer, _
    count As Integer _
)
'Usage
Dim instance As XmlWriter
Dim buffer As Char()
Dim index As Integer
Dim count As Integer

instance.WriteChars(buffer, index, count)

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

public:
virtual void WriteChars (
    array<wchar_t>^ buffer, 
    int index, 
    int count
) abstract

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

public abstract function WriteChars (
    buffer : char[], 
    index : int, 
    count : int
)

Parameter

• buffer
  Zeichenarray, das den zu schreibenden Text enthält.

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

• count
  Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	buffer ist NULL (Nothing in Visual Basic).
ArgumentOutOfRangeException	index oder count ist kleiner als 0 (null). – 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.

Hinweise

Mit dieser Methode können umfangreiche Textmengen in jeweils einen Puffer geschrieben werden.

Um zu verhindern, dass die WriteChars-Methode Ersatzzeichenpaare auf mehrere Pufferschreibvorgänge aufteilt, ist eine besondere Vorgehensweise erforderlich. Die XML-Spezifikation definiert die gültigen Bereiche für Ersatzzeichenpaare.

Beim Schreiben von Ersatzzeichenpaaren, die im Puffer aufgeteilt werden würden, wird eine Ausnahme ausgelöst. Diese Ausnahme muss abgefangen werden, damit das nächste Ersatzzeichenpaar in den Ausgabepuffer geschrieben werden kann.

Im folgenden Beispiel wird ein nach dem Zufallsprinzip generiertes Ersatzzeichenpaar beim Schreiben in den Ausgabepuffer aufgeteilt. Wenn die Ausnahme abgefangen und das Schreiben in den Puffer fortgesetzt wird, ist gewährleistet, dass das Ersatzzeichenpaar fehlerfrei in den Ausgabestream geschrieben wird.

 //Handling surrogate pair across buffer streams.
 char [] charArray = new char[4];
 char lowChar, highChar;
 Random random = new Random();
 lowChar = Convert.ToChar(random.Next(0xDC01, 0xDFFF));
 highChar = Convert.ToChar(random.Next(0xD801, 0xDBFF));
 XmlTextWriter tw = new XmlTextWriter("test.xml", null);
 tw.WriteStartElement("Root");
 charArray[0] = 'a';
 charArray[1] = 'b';
 charArray[2] = 'c';
 charArray[3] = highChar;
 try
 {
  tw. WriteChars(charArray, 0, charArray.Length);
 }
 catch (Exception ex) {
 }
 Array[0] = highChar;
 Array[1] = lowChar;
 charArray[2] = 'd';
 tw.WriteChars(charArray, 0, 3); 
 tw.WriteEndElement();

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlWriter-Klasse
XmlWriter-Member
System.Xml-Namespace

Weitere Ressourcen

Schreiben von XML mit dem "XmlWriter"