XmlTextReader.ReadElementContentAsBase64(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 Base64-Inhalt.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (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 in den 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. Die tatsächliche Anzahl der kopierten Bytes wird von dieser Methode zurückgegeben.
Gibt zurück
Die Anzahl der in den Puffer geschriebenen Bytes.
Ausnahmen
Der wert buffer ist null.
Der aktuelle Knoten ist kein Elementknoten.
Der Index im Puffer oder index + Anzahl ist größer als die zugeordnete Puffergröße.
Diese Methode wird von der XmlTextReader Implementierung nicht unterstützt.
Das Element enthält gemischten Inhalt.
Der Inhalt kann nicht in den angeforderten Typ konvertiert werden.
Beispiele
Sehen Sie XmlReader.ReadElementContentAsBase64 sich ein Beispiel mit dieser Methode an.
Hinweise
Note
Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.
Diese Methode liest den Elementinhalt, decodiert ihn mithilfe der Base64-Codierung und gibt die decodierten Binärbytes (z. B. ein inline base64-codiertes GIF-Bild) in den Puffer zurück. Weitere Informationen finden Sie unter RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanismen zum Angeben und Beschreiben des Formats von Internetnachrichtentexten". Sie können RFCs von der Website "Anfrage für Kommentare" abrufen.
Diese Methode kann nur elemente mit einfachem Inhalt lesen. Das Element kann Text, Leerzeichen, signifikante Leerzeichen, CDATA-Abschnitte, Kommentare und Verarbeitungsanweisungen enthalten. Sie kann auch Entitätsverweise enthalten, die automatisch erweitert werden. Das Element darf keine untergeordneten Elemente haben.
Diese Methode ist der ReadContentAsBase64 Methode sehr ähnlich, mit der 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 XmlTextReader Wert alle verbleibenden Bytes im Dokument und gibt die Anzahl der gelesenen Bytes zurück. Der nächste XmlTextReader 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 genutzt wurde 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 Endtagknoten, liest den nächsten Knoten und positioniert sich dann auf dem nächsten nachfolgenden Knoten.
