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

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, menulis teks satu buffer pada satu waktu.

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)

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.

ArgumentException

Nilai buffer parameter tidak valid.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

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

Keterangan

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.

Untuk versi asinkron dari metode ini, lihat WriteCharsAsync.