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

Definition

Läser elementet och avkodar Base64-innehållet.

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

Parametrar

buffer
Byte[]

Bufferten som den resulterande texten ska kopieras till. Det här värdet får inte vara null.

index
Int32

Förskjutningen till bufferten där resultatet ska börja kopieras.

count
Int32

Det maximala antalet byte som ska kopieras till bufferten. Det faktiska antalet kopierade byte returneras från den här metoden.

Returer

Antalet byte som skrivits till bufferten.

Undantag

Värdet buffer är null.

Den aktuella noden är inte en elementnod.

Indexet i bufferten eller index + antal är större än den allokerade buffertstorleken.

Elementet innehåller blandat innehåll.

Det går inte att konvertera innehållet till den begärda typen.

Exempel

Se XmlReader.ReadElementContentAsBase64 ett exempel med den här metoden.

Kommentarer

Note

För att dra nytta av nyare funktioner rekommenderar vi att du skapar XmlReader instanser med hjälp av XmlReaderSettings klassen och Create metoden. Mer information finns i avsnittet Anmärkningar på XmlReader referenssidan.

Den här metoden läser innehållet, avkodar det med Base64-kodning och returnerar de avkodade binära byteen (till exempel en infogad Base64-kodad GIF-bild) i bufferten. Mer information finns i RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". Du kan hämta RFC:er från webbplatsen Begäran om kommentarer.

Den här metoden kan bara läsa element med enkelt innehåll. Elementet kan innehålla text, tomt utrymme, betydande tomt utrymme, CDATA-avsnitt, kommentarer och bearbetningsinstruktioner. Den kan också innehålla entitetsreferenser som expanderas automatiskt. Elementet kan inte ha underordnade element.

Den här metoden liknar metoden mycket ReadContentAsBase64 , förutom att den bara kan anropas på elementnodtyper.

Om antalet är högre än antalet byte i dokumentet, eller om det är lika med antalet byte i dokumentet, XmlNodeReader läser alla återstående byte i dokumentet och returnerar antalet lästa byte. Nästa ReadElementContentAsBase64 metodanrop returnerar en nolla och flyttar läsaren till noden efter EndElement noden.

Om du anropar Read innan allt elementinnehåll förbrukas kan läsaren bete sig som om det första innehållet användes och sedan Read anropades metoden. Det innebär att läsaren läser all text tills slutelementet påträffas. Den läser sedan sluttaggnoden, läser nästa nod och placerar sig sedan på nästa efterföljande nod.

Gäller för

Se även