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

Definice

Při přepsání v odvozené třídě zapisuje text v jednu vyrovnávací paměť.When overridden in a derived class, writes text one buffer at a time.

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, který se má zapsatCharacter array containing the text to write.

index
Int32

Pozice ve vyrovnávací paměti, která označuje začátek textu k zápisu.The position in the buffer indicating the start of the text to write.

count
Int32

Počet znaků k zápisu.The number of characters to write.

Výjimky

buffer je null.buffer is null.

index nebo count je menší než nula.index or count is less than zero.

-nebo--or- Velikost vyrovnávací paměti minus index je menší než count . volání má za následek rozdělení znaků náhradního páru nebo zápis neplatného náhradního páru.The buffer length minus index is less than count; the call results in surrogate pair characters being split or an invalid surrogate pair being written.

bufferHodnota parametru není platná.The buffer parameter value is not valid.

XmlWriterMetoda byla volána před dokončením předchozí asynchronní operace.An XmlWriter method was called before a previous asynchronous operation finished. V tomto případě InvalidOperationException je vyvolána se zprávou "asynchronní operace již probíhá".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

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

Tato metoda se dá použít k zápisu velkých objemů textu po jedné vyrovnávací paměti.This method can be used to write large amounts of text one buffer at a time.

Pro zajištění, že WriteChars Metoda nerozděluje náhradní párové znaky napříč více zápisy vyrovnávací paměti, je třeba provést speciální zpracování.Special handling must be done to ensure the WriteChars method does not split surrogate pair characters across multiple buffer writes. Specifikace XML definuje platné rozsahy pro náhradní páry.The XML specification defines the valid ranges for surrogate pairs.

Asynchronní verze této metody naleznete v tématu WriteCharsAsync .For the asynchronous version of this method, see WriteCharsAsync.

Platí pro