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

Definition

Namnområde:
System.Xml
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlNodeReader.cs
Källa:
XmlNodeReader.cs
Källa:
XmlNodeReader.cs
Källa:
XmlNodeReader.cs
Källa:
XmlNodeReader.cs

Läser innehållet och returnerar binHex-avkodade binära byte.

public:
 override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBinHex(byte[] buffer, int index, int count);
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overrides Function ReadContentAsBinHex (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

Int32

Antalet byte som skrivits till bufferten.

Undantag

ArgumentNullException

Värdet buffer är null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) stöds inte på den aktuella noden.

ArgumentOutOfRangeException

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

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 strömmar innehållet, avkodar BinHex-innehållet och returnerar de avkodade binära byteen (till exempel en infogad BinHex-kodad GIF-bild) till bufferten. Den här metoden kan anropas successivt för att läsa stora strömmar av inbäddad text.

Note

Du bör inte komma åt någon av läsaregenskaperna mellan anrop till ReadContentAsBinHex metoden förrän metoden returnerar värdet 0.

Den här metoden har följande beteende:

  • ReadContentAsBinHex returnerar värdet 0 när det har nått slutet av byteströmmen som den fungerade på. Läsaren är placerad på den första noden som inte är innehåll.

  • Om du ber om färre, eller det exakta antalet, byte än vad som finns kvar i strömmen förblir läsaren i sin aktuella position.

  • ReadContentAsBinHex stöds inte på följande XML-nodtyper: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Gäller för

Se även