XmlWriter.WriteChars(Char[], Int32, Int32) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše text po jedné vyrovnávací paměti najednou.

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)

Parametry

buffer

Char[]

Pole znaků obsahující text k zápisu

index

Int32

Pozice ve vyrovnávací paměti označující začátek textu, který se má zapisovat.

count

Int32

Počet znaků, které se mají napsat.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

nebo

Délka vyrovnávací paměti je index menší než count; výsledkem volání je rozdělení náhradních párů nebo zápis neplatného páru náhradních.

ArgumentException

Hodnota parametru buffer není platná.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Příklady

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

Poznámky

Tuto metodu lze použít k zápisu velkých objemů textu po jedné vyrovnávací paměti.

Je nutné provést speciální zpracování, aby se zajistilo, WriteChars že metoda nerozdělí náhradní znaky mezi více zápisů do vyrovnávací paměti. Specifikace XML definuje platné rozsahy pro náhradní páry.

Asynchronní verzi této metody naleznete v tématu WriteCharsAsync.