XmlTextWriter.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.
Metni bir kerede bir arabelleğe yazar.
public:
override void WriteChars(cli::array <char> ^ buffer, int index, int count);public override void WriteChars (char[] buffer, int index, int count);override this.WriteChars : char[] * int * int -> unitPublic Overrides 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üçük; çağrı, vekil çift karakterlerin bölünmesine veya geçersiz bir vekil çift yazılmasıyla sonuçlanır.
WriteState kapalıdır.
Örnekler
using (XmlTextWriter writer = new XmlTextWriter(Console.Out))
{
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
Not
.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini ve XmlWriterSettings sınıfını XmlWriter.Create kullanarak örnekler oluşturmanızı XmlWriter öneririz.
Bu yöntem, her seferinde bir arabelleğe 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.
Vekil çift karakterleri yazılırsa, vekil çift karakterlerin arabellekte bölünmesine neden olacak bir özel durum oluşturulur.
