XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlValidatingReader.cs

öğesini okur ve BinHex içeriğinin kodunu çözer.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBinHex(byte[] buffer, int index, int count);

override this.ReadElementContentAsBinHex : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Parametreler

buffer

Byte[]

Sonuçta elde edilen metnin kopyalandığı arabellek. Bu değer olamaz null.

index

Int32

Sonucu kopyalamaya başlamak için arabelleğe uzaklık.

count

Int32

Arabelleğe kopyalanacak bayt sayısı üst sınırı. Kopyalanan gerçek bayt sayısı bu yöntemden döndürülür.

Döndürülenler

Int32

Arabelleğe yazılan bayt sayısı.

Özel durumlar

ArgumentNullException

buffer değeri null.

InvalidOperationException

Geçerli düğüm bir öğe düğümü değil.

ArgumentOutOfRangeException

Arabellek veya dizin + sayısındaki dizin, ayrılan arabellek boyutundan daha büyük.

NotSupportedException

Uygulama XmlValidatingReader bu yöntemi desteklemiyor.

XmlException

öğesi karma içerik içeriyor.

FormatException

İçerik istenen türe dönüştürülemez.

Açıklamalar

Note

XmlValidatingReader.NET Framework 2.0'da sınıf kullanımdan kaldırıldı. sınıfını ve XmlReader yöntemini kullanarak XmlReaderSettings bir doğrulama Create örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu yöntem öğe içeriğini okur, BinHex kodlamasını kullanarak kodunu çözer ve kod çözülen ikili baytları (örneğin, satır içi BinHex kodlanmış GIF görüntüsü) arabelleğe döndürür.

Bu yöntem yalnızca basit içerik öğelerini okuyabilir. öğesi metin, boşluk, önemli boşluk, CDATA bölümleri, açıklamalar ve işleme yönergeleri içerebilir. Ayrıca otomatik olarak genişletilen varlık başvuruları da içerebilir. öğesinin alt öğeleri olamaz.

Bu yöntem yöntemine ReadContentAsBinHex çok benzer, ancak yalnızca öğe düğümü türlerinde çağrılabilir.

count Değer belgedeki bayt sayısından yüksekse veya belgedeki bayt sayısına eşitse, XmlValidatingReader belgedeki kalan tüm baytları okur ve okunan bayt sayısını döndürür. Sonraki XmlValidatingReader yöntem çağrısı sıfır döndürür ve okuyucuyu öğesini izleyen düğüme EndElementtaşır.

Tüm öğe içeriği tüketilmeden önce çağrısı Read yaparsanız, okuyucu ilk içerik tüketilmiş ve ardından Read yöntemi çağrılmış gibi davranabilir. Bu, okuyucunun son öğeyle karşılaşılana kadar tüm metni okuyacağı anlamına gelir. Ardından bitiş etiketi düğümünü okuyacak, sonraki düğümü okuyacak ve ardından kendisini sonraki düğüme konumlandıracaktır.

Ayrıca bkz.

• XmlReader
• ReadContentAsBinHex(Byte[], Int32, Int32)