XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Yöntem

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kodlar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Xml.ReaderWriter.dll
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:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

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

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

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

Arabellek veya dizin + sayısındaki dizin, 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 çözer ve çözülen ikili baytları BinHex (ö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.

Note

yöntemi değerini ReadContentAsBinHexdöndürene kadar yöntemine 0 yapılan çağrılar arasında okuyucu özelliklerine 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üğümde konumlandırılır.

  • Akışta kalan bayt sayısının daha azını veya tam sayısını isterseniz 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.