XmlValidatingReader.ReadContentAsBinHex(Byte[], Int32, Int32) Methode

  • Referenz

Definition

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Liest den Inhalt und gibt die BinHex-decodierten binären Bytes zurück.

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

Parameter

buffer
Byte[]

Der Puffer, in den der resultierende Text kopiert werden soll. Dieser Wert darf nicht null sein.

index
Int32

Der Offset im Puffer, an dem mit dem Kopieren des Ergebnisses begonnen werden soll.

count
Int32

Die maximale Anzahl von Bytes, die in den Puffer kopiert werden sollen. Diese Methode gibt die tatsächliche Anzahl von kopierten Bytes zurück.

Gibt zurück

Int32

Die Anzahl der in den Puffer geschriebenen Bytes.

Ausnahmen

ArgumentNullException

Der buffer-Wert ist null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) wird auf dem aktuellen Knoten nicht unterstützt.

ArgumentOutOfRangeException

Der Index im Puffer oder Index + Anzahl übersteigen die Größe des zugeordneten Puffers.

NotSupportedException

Die XmlValidatingReader-Implementierung unterstützt diese Methode nicht.

Hinweise

Hinweis

Die XmlValidatingReader Klasse ist in .NET Framework 2.0 veraltet. Sie können eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.

Diese Methode streamt den Inhalt, decodest den BinHex-Inhalt und gibt die dekodierten Binärbytes (z. B. ein inline BinHex codiertes GIF-Bild) in den Puffer zurück. Diese Methode kann nacheinander aufgerufen werden, um große Datenströme von eingebetteten Text zu lesen.

Hinweis

Sie sollten nicht auf eine der Leseeigenschaften zwischen Aufrufen der ReadContentAsBinHex Methode zugreifen, bis die Methode den Wert 0 zurückgibt.

Diese Methode weist das folgende Verhalten auf:

  • ReadContentAsBinHex gibt den Wert 0 zurück, wenn er das Ende des Bytedatenstroms erreicht hat, auf dem er ausgeführt wurde. Der Leser wird auf dem ersten Nichtinhaltsknoten positioniert.

  • Wenn Sie weniger oder die genaue Zahl von Bytes anfordern, die im Stream links sind, bleibt der Leser in seiner aktuellen Position.

  • ReadContentAsBinHex wird nicht in den folgenden XML-Knotentypen unterstützt: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entität und DocumentFragment.

Gilt für

Siehe auch