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

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, 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.

C#

public abstract void WriteChars(char[] buffer, int index, int count);

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

C#

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