War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
ReadElementContentAsBinHex-Methode
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

XmlTextReader.ReadElementContentAsBinHex-Methode

Liest das Element und decodiert den BinHex-Inhalt.

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public override int ReadElementContentAsBinHex(
	byte[] buffer,
	int index,
	int count
)

Parameter

buffer
Typ: System.Byte[]
Der Puffer, in den der resultierende Text kopiert werden soll. Dieser Wert darf nicht null sein.
index
Typ: System.Int32
Der Offset im Puffer, an dem mit dem Kopieren des Ergebnisses begonnen werden soll.
count
Typ: System.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.

Rückgabewert

Typ: System.Int32
Die Anzahl der in den Puffer geschriebenen Bytes.

AusnahmeBedingung
ArgumentNullException

Der buffer-Wert ist null.

InvalidOperationException

Der aktuelle Knoten ist kein Elementknoten.

ArgumentOutOfRangeException

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

NotSupportedException

Die XmlReader-Implementierung unterstützt diese Methode nicht.

XmlException

Das Element enthält gemischten Inhalt.

FormatException

Der Inhalt kann nicht in den angeforderten Typ konvertiert werden.

HinweisHinweis

Die empfohlene Vorgehensweise für die Version .NET Framework 2.0 besteht darin, mithilfe der XmlReader.Create-Methode XmlReader-Instanzen zu erstellen. So können Sie die neuen Features dieser Version in vollem Umfang nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Readern.

Diese Methode liest den Elementinhalt, decodiert ihn mithilfe der BinHex-Codierung und gibt die decodierten binären Bytes (z. B. für ein inline mit BinHex codiertes GIF-Bild) in den Puffer zurück.

Diese Methode kann nur Elemente mit einfachem Inhalt lesen. Das Element darf Text, Leerraum, signifikanten Leerraum, CDATA-Abschnitte, Kommentare und Verarbeitungsanweisungen enthalten. Es darf auch Entitätsverweise enthalten, die automatisch erweitert werden. Das Element darf keine untergeordneten Elemente enthalten.

Diese Methode ähnelt der ReadContentAsBinHex-Methode, aber sie kann nur auf Elementknotentypen aufgerufen werden.

Wenn der count-Wert größer oder gleich der Anzahl von Bytes im Dokument ist, liest XmlTextReader alle verbleibenden Bytes im Dokument und gibt die Anzahl der gelesenen Bytes zurück. Der nächste Aufruf der XmlTextReader-Methode gibt 0 (null) zurück, und der Reader wechselt auf den Knoten hinter dem EndElement.

Wenn Sie Read aufrufen, bevor der gesamte Elementinhalt verbraucht ist, verhält sich der Reader so, als wäre der erste Inhalt verbraucht und anschließend die Read-Methode aufgerufen worden. Dies bedeutet, dass der Reader den gesamten Text bis zum Endelement liest. Anschließend liest er den Knoten am Endtag und den nachfolgenden Knoten, und dann wird er auf dem darauf folgenden Knoten positioniert.

Ein Beispiel für die Verwendung dieser Methode finden Sie unter XmlReader.ReadElementContentAsBinHex.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft