Aracılığıyla paylaş


XmlWriter.WriteChars(Char[], Int32, Int32) Yöntem

Tanım

Türetilmiş bir sınıfta geçersiz kılındığında, metni bir kerede bir arabellek yazar.

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)

Parametreler

buffer
Char[]

Yazacak metni içeren karakter dizisi.

index
Int32

Yazacak metnin başlangıcını gösteren arabellekteki konum.

count
Int32

Yazılacak karakter sayısı.

Özel durumlar

buffer, null değeridir.

index veya count sıfırdan küçüktür.

-veya-

Arabellek uzunluğu eksi index değerinden countküçüktür; çağrı, vekil çift karakterlerin bölünmesine veya geçersiz bir vekil çiftin yazılmasıyla sonuçlanır.

buffer Parametre değeri geçerli değil.

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

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

Açıklamalar

Bu yöntem, her seferinde bir arabellekte büyük miktarda metin yazmak için kullanılabilir.

Yöntemin WriteChars vekil çift karakterleri birden çok arabellek yazma işlemi arasında bölmediğinden emin olmak için özel işleme yapılmalıdır. XML belirtimi, vekil çiftler için geçerli aralıkları tanımlar.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteCharsAsync. .

Şunlara uygulanır