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

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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ären Bytes 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 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 vom aktuellen Knoten nicht unterstützt.

ArgumentOutOfRangeException

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

Hinweise

Hinweis

Ab dem .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReader.Create -Methode zu erstellenXmlReader, um neue Funktionen zu nutzen.

Diese Methode streamt den Inhalt, decodiert den Base64 Inhalt und gibt die decodierten binären Bytes (z. B. ein inlinecodiertes Base64GIF-Bild) in den Puffer zurück. Diese Methode kann nacheinander aufgerufen werden, um große Datenströme eingebetteten Texts zu lesen. Weitere Informationen finden Sie unter RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Body". Sie können RFCs auf der Website "Anforderung für Kommentare" abrufen.

Hinweis

Sie sollten zwischen Aufrufen der -Methode nicht auf eine der Readereigenschaften zugreifen, ReadContentAsBase64 bis die Methode den Wert 0 zurü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 Reader befindet sich auf dem ersten Nichtinhaltsknoten.
Wenn Sie nach weniger oder der genauen Anzahl von Bytes fragen, als im Stream verbleiben, verbleibt der Reader an seiner aktuellen Position.
ReadContentAsBase64wird für die folgenden XML-Knotentypen nicht unterstützt: Element, XmlDeclaration, DocumentNone, DocumentType, Notation, EntityDocumentFragment.

Gilt für: