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

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Zapisuje tekst jeden bufor naraz.

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

Tablica znaków zawierająca tekst do zapisu.

index

Int32

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

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.

InvalidOperationException

Element WriteState jest zamknięty.

Przykłady

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

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, zalecamy utworzenie XmlWriter wystąpień przy użyciu metody i XmlWriterSettings klasy, aby korzystać z XmlWriter.Create nowych funkcji.

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

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

Wyjątek jest zgłaszany, jeśli znaki pary zastępczej są zapisywane, co spowoduje podzielenie znaków pary zastępczej w buforze.