Udostępnij za pośrednictwem


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

Definicja

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

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.

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