XmlWriter.WriteChars(Char[], Int32, Int32) Metódus

Definíció

Névtér:

System.Xml

Szerelvény:

System.Xml.dll

Ha felül van bírálva egy származtatott osztályban, egyszerre csak egy puffert ír.

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)

Paraméterek

buffer

Char[]

Az írandó szöveget tartalmazó karaktertömb.

index

Int32

A puffer pozíciója, amely az írandó szöveg kezdetét jelzi.

count

Int32

Az írandó karakterek száma.

Kivételek

ArgumentNullException

buffer az null.

ArgumentOutOfRangeException

index vagy count kisebb, mint nulla.

-vagy-

A puffer hossza mínusz index kisebb, mint count; a hívás azt eredményezi, hogy a helyettesítő pár karakterei felosztásra kerülnek, vagy érvénytelen helyettesítő pár van megírva.

ArgumentException

A buffer paraméter értéke érvénytelen.

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

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

Megjegyzések

Ezzel a módszerrel egyszerre nagy mennyiségű szöveget írhat egy pufferben.

Speciális kezelést kell végezni annak érdekében, hogy a metódus ne ossza fel a WriteChars helyettesítő pár karaktereit több pufferírás között. Az XML-specifikáció meghatározza a helyettesítő párok érvényes tartományait.

A metódus aszinkron verziójáról lásd WriteCharsAsync: .