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

Definitie

Naamruimte:
System.Xml
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Bron:
XmlTextWriter.cs
Bron:
XmlTextWriter.cs
Bron:
XmlTextWriter.cs
Bron:
XmlTextWriter.cs
Bron:
XmlTextWriter.cs

Hiermee schrijft u tekst één buffer tegelijk.

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)

Parameters

buffer
Char[]

Tekenmatrix met de tekst die moet worden geschreven.

index
Int32

De positie in de buffer die het begin van de te schrijven tekst aangeeft.

count
Int32

Het aantal tekens dat moet worden geschreven.

Uitzonderingen

ArgumentNullException

buffer is null.

ArgumentOutOfRangeException

index of count kleiner is dan nul.

– of –

De bufferlengte min index is kleiner dan count; de aanroep resulteert in surrogaatpaartekens die worden gesplitst of een ongeldig surrogaatpaar dat wordt geschreven.

InvalidOperationException

De WriteState is gesloten.

Voorbeelden

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();
}

Opmerkingen

Note

U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.

Deze methode kan worden gebruikt om grote hoeveelheden tekst één buffer tegelijk te schrijven.

Er moet speciale verwerking worden uitgevoerd om ervoor te zorgen dat de WriteChars methode geen surrogaatpaartekens over meerdere bufferschrijfbewerkingen splitst. De XML-specificatie definieert de geldige bereiken voor surrogaatparen.

Er wordt een uitzondering gegenereerd als surrogaatpaartekens worden geschreven waardoor de surrogaatpaartekens in de buffer worden gesplitst.

Van toepassing op