Sdílet prostřednictvím


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

Definice

Zapíše text do vyrovnávací paměti najednou.

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)

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

buffer je null.

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árů znaků nebo zápisu neplatného náhradního páru.

Příklady

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

Poznámky

Poznámka

Počínaje verzí .NET Framework 2.0 doporučujeme vytvářet XmlWriter instance pomocí XmlWriter.Create metody a XmlWriterSettings třídy, abyste mohli využívat nové funkce.

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

Zvláštní zpracování musí být provedeno, aby se zajistilo, že WriteChars metoda nerozdělí náhradní párové znaky napříč více zápisy do vyrovnávací paměti. Specifikace XML definuje platné rozsahy pro náhradní páry.

Výjimka se vyvolá, pokud se zapíšou náhradní párové znaky, které by vedlo k rozdělení náhradních párových znaků do vyrovnávací paměti.

Platí pro