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

ArgumentOutOfRangeException

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

NotSupportedException

Uygulama XmlTextReader bu yöntemi desteklemiyor.

Açıklamalar

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini kullanarak XmlReader.Create örnekler oluşturmanızı XmlReader öneririz.

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öntem 0 değerini dö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 0 değerini 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

Şunlara uygulanır

Ayrıca bkz.