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

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
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:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs

Läser innehållet och returnerar de BinHex avkodade binära byteen.

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

-eller-

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

ArgumentOutOfRangeException

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

NotSupportedException

Implementeringen XmlReader stöder inte den här metoden.

Kommentarer

Den här metoden strömmar innehållet, avkodar BinHex innehållet och returnerar de avkodade binära byteen (till exempel en infogad BinHex 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.

Den asynkrona versionen av den här metoden finns i ReadContentAsBinHexAsync.

Gäller för

Se även