Aracılığıyla paylaş

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

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
XmlNodeReader.cs
Kaynak:
XmlNodeReader.cs
Kaynak:
XmlNodeReader.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şlanacak arabelleğe uzaklık.

count
Int32

Arabelleğe kopyalanacak en fazla bayt sayısı. 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 olur.

InvalidOperationException

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

ArgumentOutOfRangeException

Arabelleğe veya dizin + sayım dizinine ayrılan arabellek boyutundan daha büyük.

XmlException

öğesi karışık içerik içeriyor.

FormatException

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

Örnekler

Bu yöntemi kullanarak bir örnek görmek için bkz XmlReader.ReadElementContentAsBinHex .

Açıklamalar

Not

.NET Framework 2.0'da önerilen uygulama, sınıfını ve Create yöntemini kullanarak XmlReaderSettings örnekler oluşturmaktırXmlReader. Bu, .NET Framework sunulan tüm yeni özelliklerden tam olarak yararlanmanızı sağlar. Daha fazla bilgi için başvuru sayfasındaki Açıklamalar bölümüne XmlReader bakın.

Bu yöntem öğe içeriğini okur, BinHex kodlamasını kullanarak kodunu çözer ve çö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.

Sayı değeri belgedeki bayt sayısından yüksekse veya belgedeki bayt sayısına eşitse, XmlNodeReader belgedeki kalan tüm baytları okur ve okunan bayt sayısını döndürür. Sonraki XmlNodeReader yöntem çağrısı sıfır döndürür ve okuyucuyu düğümü izleyen düğüme EndElement taşır.

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

Şunlara uygulanır

Ayrıca bkz.