XmlValidatingReader.ReadElementContentAsBinHex(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 das Element und decodiert den BinHex-Inhalt.
public:
override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);override this.ReadElementContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBinHex (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.
Der aktuelle Knoten ist kein Elementknoten.
Der Index im Puffer oder Index + Anzahl übersteigen die Größe des zugeordneten Puffers.
Die XmlValidatingReader-Implementierung unterstützt diese Methode nicht.
Das Element enthält gemischten Inhalt.
Der Inhalt kann nicht in den angeforderten Typ konvertiert werden.
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 liest den Elementinhalt, dekodiert ihn mithilfe der BinHex-Codierung und gibt die decodierten Binärbytes (z. B. ein inline-binHex-codiertes GIF-Bild) in den Puffer zurück.
Diese Methode kann nur einfache Inhaltselemente lesen. Das Element kann Text, Leerraum, signifikante Leerzeichen, CDATA-Abschnitte, Kommentare und Verarbeitungsanweisungen enthalten. Sie kann auch Entitätsverweise enthalten, die automatisch erweitert werden. Das Element kann nicht über untergeordnete Elemente verfügen.
Diese Methode ist der ReadContentAsBinHex Methode sehr ähnlich, außer dass sie nur bei Elementknotentypen aufgerufen werden kann.
Wenn der count Wert höher als die Anzahl der Bytes im Dokument ist oder gleich der Anzahl der Bytes im Dokument ist, liest der XmlValidatingReader wert alle verbleibenden Bytes im Dokument und gibt die Anzahl der Gelesenen zurück. Der nächste XmlValidatingReader Methodenaufruf gibt eine Null zurück und verschiebt den Leser nach dem EndElementKnoten.
Wenn Sie aufrufen Read , bevor alle Elementinhalte genutzt werden, verhält sich der Leser möglicherweise so, als ob der erste Inhalt verbraucht wurde und die Read Methode aufgerufen wurde. Dies bedeutet, dass der Leser den gesamten Text liest, bis das Endelement aufgetreten ist. Anschließend wird der Endtagknoten gelesen, der nächste Knoten gelesen und sich dann auf dem nächsten nachfolgenden Knoten positioniert.