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

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlTextWriter.cs

Menulis teks satu buffer pada satu waktu.

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)

Parameter

buffer

Char[]

Array karakter yang berisi teks untuk ditulis.

index

Int32

Posisi dalam buffer yang menunjukkan awal teks untuk ditulis.

count

Int32

Jumlah karakter yang akan ditulis.

Pengecualian

ArgumentNullException

buffer adalah null.

ArgumentOutOfRangeException

index atau count kurang dari nol.

-atau-

Panjang buffer minus index kurang dari count; panggilan menghasilkan karakter pasangan pengganti yang dipisahkan atau pasangan pengganti tidak valid sedang ditulis.

InvalidOperationException

Ditutup WriteState .

Contoh

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

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

Metode ini dapat digunakan untuk menulis sejumlah besar teks satu buffer pada satu waktu.

Penanganan khusus harus dilakukan untuk memastikan WriteChars metode tidak membagi karakter pasangan pengganti di beberapa penulisan buffer. Spesifikasi XML menentukan rentang yang valid untuk pasangan pengganti.

Pengecualian dilemparkan jika karakter pasangan pengganti ditulis yang akan mengakibatkan karakter pasangan pengganti dibagi dalam buffer.