XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Metódus

Definíció

Névtér:
System.Xml
Szerelvények:
System.Xml.dll, System.Xml.ReaderWriter.dll
Szerelvények:
netstandard.dll, System.Xml.ReaderWriter.dll
Szerelvény:
System.Xml.ReaderWriter.dll
Szerelvény:
System.Xml.dll
Szerelvény:
netstandard.dll
Forrás:
XmlReader.cs
Forrás:
XmlReader.cs
Forrás:
XmlReader.cs
Forrás:
XmlReader.cs
Forrás:
XmlReader.cs

Beolvassa a tartalmat, és visszaadja a BinHex dekódolt bináris bájtokat.

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

Paraméterek

buffer
Byte[]

Az a puffer, amelybe az eredményül kapott szöveget másolja. Ez az érték nem lehet null.

index
Int32

Az eltolás a pufferbe, ahol elkezdi az eredmény másolását.

count
Int32

A pufferbe másolandó bájtok maximális száma. A program a másolt bájtok tényleges számát adja vissza ebből a metódusból.

Válaszok

Int32

A pufferbe írt bájtok száma.

Kivételek

ArgumentNullException

Az buffer érték a következő null: .

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) nem támogatott az aktuális csomóponton.

-vagy-

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

ArgumentOutOfRangeException

A pufferbe vagy indexbe való index + darabszám nagyobb, mint a lefoglalt pufferméret.

NotSupportedException

A XmlReader megvalósítás nem támogatja ezt a módszert.

Megjegyzések

Ez a metódus streameli a tartalmat, dekódolja a BinHex tartalmat, és visszaadja a dekódolt bináris bájtokat (például egy beágyazott BinHex GIF-képet) a pufferbe. Ezt a metódust egymás után lehet meghívni nagy beágyazott szövegfolyamok olvasásához.

Note

Nem érheti el az olvasó tulajdonságait a metódus hívásai ReadContentAsBinHex között, amíg a metódus vissza nem adja az értéket 0.

Ez a módszer a következő viselkedést követi:

  • ReadContentAsBinHex az értéket 0 adja vissza, amikor elérte a bájtfolyam végét, amelyen az üzemelt. Az olvasó az első nem tartalomcsomóponton van elhelyezve.

  • Ha kevesebb bájtot vagy pontos számot kér, mint amennyit a streamben hagy, az olvasó a jelenlegi helyén marad.

  • ReadContentAsBinHexa következő XML-csomóponttípusok nem támogatottak: Element, , XmlDeclaration, NoneDocument, DocumentType, Notation, EntityDocumentFragment.

A metódus aszinkron verziójáról lásd ReadContentAsBinHexAsync: .

A következőre érvényes:

Lásd még