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

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlTextWriter.cs

Zapíše text po jedné vyrovnávací paměti.

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ů, 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.

InvalidOperationException

The WriteState is Closed.

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

Note

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 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.

Výjimka je vyvolána, pokud jsou zapsány znaky náhradní dvojice, což by vedlo k rozdělení náhradních párových znaků do vyrovnávací paměti.