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

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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ů k zápisu.

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; volání vede k rozdělení náhradních párových znaků nebo k zápisu neplatného náhradního páru.

ArgumentException

Hodnota parametru buffer není platná.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již 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 najednou.

Speciální zpracování musí být provedeno, aby se zajistilo WriteChars , že metoda nerozdělí náhradní párové znaky mezi více zápisů do vyrovnávací paměti. Specifikace XML definuje platné rozsahy pro náhradní páry.

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