Udostępnij za pośrednictwem


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

Definicja

Podczas zastępowania w klasie pochodnej zapisuje tekst jeden bufor naraz.

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[]

Tablica znaków zawierająca tekst do zapisania.

index
Int32

Pozycja w buforze wskazująca początek tekstu do zapisania.

count
Int32

Liczba znaków, jaka ma zostać zapisana.

Wyjątki

buffer to null.

index wartość lub count jest mniejsza niż zero.

-lub- Długość buforu minus index jest mniejsza niż count; wywołanie powoduje podzielenie znaków pary zastępczej lub zapisanie nieprawidłowej pary zastępczej.

Wartość parametru jest nieprawidłowa buffer .

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

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

Uwagi

Ta metoda może służyć do zapisywania dużych ilości tekstu w jednym buforze jednocześnie.

Należy wykonać specjalną obsługę, aby upewnić się, że WriteChars metoda nie dzieli znaków par zastępczych między wiele zapisów buforu. Specyfikacja XML definiuje prawidłowe zakresy dla par zastępczych.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteCharsAsync.

Dotyczy