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

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlTextWriter.cs

Metni bir kerede bir arabellek 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

Yazacak karakter sayısı.

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

-veya-

Arabellek uzunluğu eksi index değeri küçüktür count; çağrı, vekil çift karakterlerin bölünmesine veya geçersiz bir vekil çift yazılmasıyla sonuçlanır.

InvalidOperationException

Kapalı WriteState .

Ö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

Note

XmlWriter öneririz ki, yeni işlevlerden yararlanmak için XmlWriter.Create yöntemi ve XmlWriterSettings sınıfını kullanarak örnekler oluşturun.

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 arabelleğe bölünmesine neden olacak bir özel durum oluşturulur.