XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlNodeReader.cs

Source:: XmlNodeReader.cs

Source:: XmlNodeReader.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 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 -> int

Public Overrides Function ReadElementContentAsBase64 (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

Der aktuelle Knoten ist kein Elementknoten.

ArgumentOutOfRangeException

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

XmlException

Das Element enthält gemischten Inhalt.

FormatException

Der Inhalt kann nicht in den angeforderten Typ konvertiert werden.

Beispiele

Sehen Sie XmlReader.ReadElementContentAsBase64 sich ein Beispiel für die Verwendung dieser Methode an.

Hinweise

Hinweis

Im .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReaderSettings -Klasse und der Create -Methode zu erstellenXmlReader. Dadurch können Sie alle neuen Features, die in der .NET Framework eingeführt wurden, in vollem Umfang nutzen. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Diese Methode liest den Inhalt, decodiert ihn mithilfe der Base64-Codierung und gibt die decodierten binären Bytes (z. B. ein Base64-codiertes GIF-Bild) in den Puffer zurück. 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.

Diese Methode kann nur Elemente mit einfachem Inhalt lesen. Das Element kann Text, Leerzeichen, erhebliche 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 -Methode sehr ähnlich, mit der ReadContentAsBase64 Ausnahme, dass sie nur für Elementknotentypen aufgerufen werden kann.

Wenn der Wert für die Anzahl höher als die Anzahl der Bytes im Dokument ist oder gleich der Anzahl der Bytes im Dokument ist, liest der XmlNodeReader alle verbleibenden Bytes im Dokument und gibt die Anzahl der gelesenen Bytes zurück. Der nächste ReadElementContentAsBase64 Methodenaufruf gibt eine Null zurück und verschiebt den Reader auf den Knoten nach dem EndElement Knoten.

Wenn Sie aufrufen Read , bevor der gesamte Elementinhalt genutzt wird, verhält sich der Reader möglicherweise so, als ob der erste Inhalt genutzt und dann die Read -Methode aufgerufen wurde. Dies bedeutet, dass der Reader 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.

Gilt für:

Share via