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

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlWriter.cs

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

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

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.

ArgumentException

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

InvalidOperationException

Ö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. .