XmlValidatingReader.ReadElementContentAsBase64(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 het element en ontsleutelt de Base64-inhoud.
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
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.
Het huidige knooppunt is geen elementknooppunt.
De index in de buffer of index + count is groter dan de toegewezen buffergrootte.
De XmlValidatingReader implementatie biedt geen ondersteuning voor deze methode.
Het element bevat gemengde inhoud.
De inhoud kan niet worden geconverteerd naar het aangevraagde type.
Opmerkingen
Note
De klasse XmlValidatingReader is verouderd in .NET Framework 2.0. U kunt een validatie-exemplaar XmlReader maken met behulp van de XmlReaderSettings klasse en de Create methode. Zie de sectie Opmerkingen van de XmlReader referentiepagina voor meer informatie.
Deze methode leest de inhoud van het element, ontsleutelt deze met Base64-codering en retourneert de gedecodeerde binaire bytes (bijvoorbeeld een inline Base64 gecodeerde GIF-installatiekopieƫn) in de buffer. 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.
Met deze methode kunnen alleen elementen van eenvoudige inhoud worden gelezen. Het element kan tekst, witruimte, aanzienlijke witruimte, CDATA-secties, opmerkingen en verwerkingsinstructies bevatten. Het kan ook entiteitsverwijzingen bevatten, die automatisch worden uitgebreid. Het element mag geen onderliggende elementen bevatten.
Deze methode is vergelijkbaar met de ReadContentAsBase64 methode, behalve dat deze alleen op elementknooppunttypen kan worden aangeroepen.
Als de count waarde hoger is dan het aantal bytes in het document of als deze gelijk is aan het aantal bytes in het document, XmlValidatingReader worden alle resterende bytes in het document gelezen en wordt het aantal gelezen bytes geretourneerd. De volgende XmlValidatingReader methode-aanroep retourneert een nul en verplaatst de lezer naar het knooppunt na de EndElement.
Als u aanroept Read voordat alle elementinhoud wordt gebruikt, gedraagt de lezer zich mogelijk alsof de eerste inhoud is verbruikt en vervolgens de Read methode is aangeroepen. Dit betekent dat de lezer alle tekst leest totdat het eindelement wordt aangetroffen. Vervolgens wordt het eindtagknooppunt gelezen, het volgende knooppunt gelezen en vervolgens op het volgende knooppunt geplaatst.