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

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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.

Dotyczy

Share via