XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Methode

Definition

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 -> int
Public Overrides Function ReadElementContentAsBinHex (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

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.

Das Element enthält gemischten Inhalt.

Der Inhalt kann nicht in den angeforderten Typ konvertiert werden.

Beispiele

Sehen Sie XmlReader.ReadElementContentAsBinHex sich ein Beispiel für die Verwendung dieser Methode an.

Hinweise

Hinweis

Im .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReaderSettings -Klasse und der Create -Methode zu erstellenXmlReader. Dadurch können Sie alle neuen Features nutzen, die im .NET Framework eingeführt wurden. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Diese Methode liest den Elementinhalt, decodiert ihn mithilfe der BinHex-Codierung und gibt die decodierten Binärbytes (z. B. ein inlinees BinHex-codiertes GIF-Bild) in den Puffer zurück.

Diese Methode kann nur Elemente mit einfachem Inhalt 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 keine untergeordneten Elemente aufweisen.

Diese Methode ist der Methode sehr ähnlich, mit der ReadContentAsBinHex Ausnahme, dass sie nur für 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 XmlNodeReader alle verbleibenden Bytes im Dokument und gibt die Anzahl der gelesenen Bytes zurück. Der nächste XmlNodeReader Methodenaufruf gibt eine Null zurück und verschiebt den Leser auf den Knoten nach dem EndElement Knoten.

Wenn Sie aufrufen Read , bevor der gesamte Elementinhalt verbraucht wird, verhält sich der Reader möglicherweise so, als ob der erste Inhalt genutzt und dann die Read -Methode aufgerufen wurde. Dies bedeutet, dass der Leser den gesamten Text liest, bis das Endelement gefunden wird. Anschließend liest er den Endpunktknoten, liest den nächsten Knoten und positioniert sich dann auf dem nächsten nachfolgenden Knoten.

Gilt für:

Weitere Informationen