XmlReader.ReadContentAsBinHex(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

İçeriği okur ve kodu çözülen ikili baytları BinHex döndürür.

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (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 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 olur.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) geçerli düğümde desteklenmiyor.

-veya-

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

ArgumentOutOfRangeException

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

NotSupportedException

Uygulama XmlReader bu yöntemi desteklemiyor.

Açıklamalar

Bu yöntem içeriği akışa alır, içeriğin kodunu BinHex çözer ve kodu çö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, ekli metinlerin büyük akışlarını okumak için ardışık olarak çağrılabilir.

Not

yöntemi değerini 0döndürene kadar yöntemine ReadContentAsBinHex yapılan çağrılar arasında okuyucu özelliklerinin hiçbirine erişmemelisiniz.

Bu yöntem aşağıdaki davranışa sahiptir:

  • ReadContentAsBinHex , üzerinde çalıştırıldığı bayt akışının sonuna ulaştığında değeri 0 döndürür. Okuyucu, içerik olmayan ilk düğüme konumlandırılır.

  • Akışta kalan bayt sayısının daha azını veya tam sayısını sorarsanız okuyucu geçerli konumunda kalır.

  • ReadContentAsBinHex şu XML düğümü türlerinde desteklenmez: Element, XmlDeclaration, None, Document, DocumentType, , Notation, Entity, DocumentFragment.

Bu yöntemin zaman uyumsuz sürümü için bkz ReadContentAsBinHexAsync. .

Şunlara uygulanır

Ayrıca bkz.