XmlTextReader.ReadContentAsBinHex(Byte[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> intPublic Overrides Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As IntegerParameter
- 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
Die Anzahl der in den Puffer geschriebenen Bytes.
Ausnahmen
Der buffer-Wert ist null.
ReadContentAsBinHex(Byte[], Int32, Int32) wird auf dem aktuellen Knoten nicht unterstützt.
Der Index im Puffer oder Index + Anzahl übersteigen die Größe des zugeordneten Puffers.
Die XmlTextReader-Implementierung unterstützt diese Methode nicht.
Hinweise
Hinweis
Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.
Diese Methode streamt den Inhalt, decodest den BinHex Inhalt und gibt die dekodierten Binärbytes (z. B. ein BinHex inline 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 Datenstrom verbleiben, bleibt der Leser in seiner aktuellen Position.
ReadContentAsBinHexwird nicht in den folgenden XML-Knotentypen unterstützt:
Element,None``Document``XmlDeclaration``DocumentType``Notation``Entity.DocumentFragment