XmlWriter.WriteChars(Char[], Int32, Int32) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 -> unitPublic 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. .
