XmlReader.ReadContentAsBase64(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 base64 decodierten Binärbytes zurück.
public:
virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public virtual int ReadContentAsBase64(byte[] buffer, int index, int count);abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> intPublic Overridable Function ReadContentAsBase64 (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.
ReadContentAsBase64(Byte[], Int32, Int32) wird für den aktuellen Knoten nicht unterstützt.
-oder-
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.
Der Index im Puffer oder index + Anzahl ist größer als die zugeordnete Puffergröße.
Diese Methode wird von der XmlReader Implementierung nicht unterstützt.
Hinweise
Diese Methode streamt den Inhalt, decodiert den Base64 Inhalt und gibt die decodierten Binärbytes (z. B. ein inlinecodiertes Base64 GIF-Bild) in den Puffer zurück. Diese Methode kann nacheinander aufgerufen werden, um große Datenströme von eingebetteten Text zu lesen. 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.
Note
Sie sollten nicht auf eine der Leseeigenschaften zwischen Aufrufen der ReadContentAsBase64 Methode zugreifen, bis die Methode den Wert 0zurückgibt.
Diese Methode hat das folgende Verhalten:
ReadContentAsBase64 gibt den Wert
0zurück, wenn er das Ende des Bytedatenstroms erreicht hat, auf dem er ausgeführt wurde. Der Leser wird auf dem ersten Nicht-Inhaltsknoten positioniert.Wenn Sie weniger oder die genaue Anzahl von Bytes anfordern, die im Datenstrom verbleiben, bleibt der Leser an seiner aktuellen Position.
ReadContentAsBase64wird für die folgenden XML-Knotentypen nicht unterstützt:
Element, ,XmlDeclaration,None,Document,DocumentType,Notation, .EntityDocumentFragment.
Die asynchrone Version dieser Methode finden Sie unter ReadContentAsBase64Async.
