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

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

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

InvalidOperationException

Je WriteState uzavřeno.

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.