XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) Methode

  • Referenz

Definition

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Liest den Inhalt und gibt die Base64-decodierten binären Bytes 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 -> int
Public Overridable Function ReadContentAsBase64 (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

Int32

Die Anzahl der in den Puffer geschriebenen Bytes.

Ausnahmen

ArgumentNullException

Der buffer-Wert ist null.

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) wird auf dem aktuellen Knoten nicht unterstützt.

- oder -

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

ArgumentOutOfRangeException

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

NotSupportedException

Die XmlReader-Implementierung unterstützt diese Methode nicht.

Hinweise

Diese Methode streamt den Inhalt, dekodiert 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 über die Website "Anfrage für Kommentare" abrufen.

Hinweis

Sie sollten nicht auf eine der Leseeigenschaften zwischen Aufrufen der ReadContentAsBase64 Methode zugreifen, bis die Methode den Wert 0zurückgibt.

Diese Methode weist das folgende Verhalten auf:

  • ReadContentAsBase64 gibt den Wert 0 zurück, wenn er das Ende des Bytedatenstroms erreicht hat, auf dem er ausgeführt wurde. Der Leser wird auf dem ersten Nichtinhaltsknoten 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, DocumentType``Document, , Notation, . Entity``DocumentFragment

Die asynchrone Version dieser Methode finden Sie unter ReadContentAsBase64Async.

Gilt für

Siehe auch