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

Definition

Liest den Inhalt und gibt die base64 decodierten Binärbytes zurück.

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBase64(byte[] buffer, int index, int count);
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overrides 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 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.

Der Index im Puffer oder index + Anzahl ist größer als die zugeordnete Puffergröße.

Hinweise

Note

Die XmlValidatingReader Klasse ist in .NET Framework 2.0 veraltet. Sie können eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Diese Methode streamt den Inhalt, decodiert den Base64-Inhalt und gibt die decodierten Binärbytes (z. B. ein inline base64-codiertes 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 0 zurückgibt.

Diese Methode hat das folgende Verhalten:

  • 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 Nicht-Inhaltsknoten positioniert.

  • Wenn Sie weniger oder die genaue Anzahl von Bytes anfordern, die im Datenstrom verbleiben, verbleibt der Leser an seiner aktuellen Position.

  • ReadContentAsBase64 wird für die folgenden XML-Knotentypen nicht unterstützt: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity und DocumentFragment.

Gilt für:

Weitere Informationen