XmlWriter.WriteChars(Char[], Int32, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer tekst in een afgeleide klasse wordt overschreven, schrijft u tekst één buffer tegelijk.
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 -> unitPublic MustOverride 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
buffer is null.
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.
De buffer parameterwaarde is ongeldig.
Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.
Voorbeelden
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();
}
Opmerkingen
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.
Zie voor de asynchrone versie van deze methode WriteCharsAsync.
