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

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlTextWriter.cs

Egyszerre csak egy puffert ír.

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)

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.

InvalidOperationException

A WriteState be van zárva.

Példák

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

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

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.

Kivétel akkor keletkezik, ha a helyettesítő pár karakterei olyan karaktereket írnak, amelyek a helyettesítő pár karaktereinek felosztását eredményezik a pufferben.