XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Leest de inhoud en retourneert de met Base64 gedecodeerde binaire bytes.
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
Parameters
- buffer
- Byte[]
De buffer waarin de resulterende tekst moet worden gekopieerd. Deze waarde kan niet zijn null.
- index
- Int32
De offset in de buffer waar het resultaat moet worden gekopieerd.
- count
- Int32
Het maximum aantal bytes dat moet worden gekopieerd naar de buffer. Het werkelijke aantal gekopieerde bytes wordt geretourneerd door deze methode.
Retouren
Het aantal bytes dat naar de buffer is geschreven.
Uitzonderingen
De buffer waarde is null.
ReadContentAsBase64(Byte[], Int32, Int32) wordt niet ondersteund op het huidige knooppunt.
– of –
Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.
De index in de buffer of index + count is groter dan de toegewezen buffergrootte.
De XmlReader implementatie biedt geen ondersteuning voor deze methode.
Opmerkingen
Deze methode streamt de inhoud, ontsleutelt de Base64 inhoud en retourneert de gedecodeerde binaire bytes (bijvoorbeeld een inline Base64 gecodeerde GIF-afbeelding) in de buffer. Deze methode kan opeenvolgend worden aangeroepen om grote stromen ingesloten tekst te lezen. Zie RFC 1521, "MIME (Multipurpose Internet Mail Extensions) deel 1 voor meer informatie: Mechanismen voor het opgeven en beschrijven van de indeling van internetberichtteksten. U kunt RFC's verkrijgen via de website Request for Comments.
Note
U moet geen toegang krijgen tot een van de lezereigenschappen tussen aanroepen naar de ReadContentAsBase64 methode totdat de methode de waarde 0retourneert.
Deze methode heeft het volgende gedrag:
ReadContentAsBase64 retourneert de waarde
0wanneer deze het einde van de bytestroom heeft bereikt waarop deze is uitgevoerd. De lezer bevindt zich op het eerste niet-inhoudsknooppunt.Als u om minder of het exacte aantal bytes vraagt dan in de stroom, blijft de lezer in de huidige positie.
ReadContentAsBase64wordt niet ondersteund op de volgende XML-knooppunttypen:
Element,XmlDeclaration,None,Document,DocumentType,Notation, .EntityDocumentFragment
Zie voor de asynchrone versie van deze methode ReadContentAsBase64Async.