XmlNodeReader.ReadElementContentAsBinHex(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 BinHex-inhoud.
public:
override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBinHex(byte[] buffer, int index, int count);override this.ReadElementContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As IntegerParameters
- 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.
Het element bevat gemengde inhoud.
De inhoud kan niet worden geconverteerd naar het aangevraagde type.
Voorbeelden
Bekijk XmlReader.ReadElementContentAsBinHex een voorbeeld met deze methode.
Opmerkingen
Note
Als u wilt profiteren van nieuwere functies, is het raadzaam om exemplaren te maken XmlReader met behulp van de XmlReaderSettings klasse en de Create methode. Zie de sectie Opmerkingen op de XmlReader referentiepagina voor meer informatie.
Met deze methode wordt de inhoud van het element gelezen, gedecodeerd met binHex-codering en wordt de gedecodeerde binaire bytes (bijvoorbeeld een inline BinHex gecodeerde GIF-afbeelding) in de buffer geretourneerd.
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 ReadContentAsBinHex methode, behalve dat deze alleen kan worden aangeroepen op elementknooppunttypen.
Als de tellingswaarde hoger is dan het aantal bytes in het document of gelijk is aan het aantal bytes in het document, XmlNodeReader worden alle resterende bytes in het document gelezen en wordt het aantal gelezen bytes geretourneerd. De volgende XmlNodeReader methode-aanroep retourneert een nul en verplaatst de lezer naar het knooppunt na het EndElement knooppunt.
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.
