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

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

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

ArgumentNullException

buffer to null.

ArgumentOutOfRangeException

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.

ArgumentException

Wartość parametru jest nieprawidłowa buffer .

InvalidOperationException

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.