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

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlTextWriter.cs

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 -> unit

Public 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

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

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.

InvalidOperationException

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.