XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Metódus

Definíció

Beolvassa az elemet, és dekódolja a BinHex-tartalmat.

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 -> int
Public Overrides Function ReadElementContentAsBinHex (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

A pufferbe írt bájtok száma.

Kivételek

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

Az aktuális csomópont nem elemcsomópont.

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

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

Az elem vegyes tartalmat tartalmaz.

A tartalom nem konvertálható a kért típusra.

Megjegyzések

Note

A XmlValidatingReader osztály elavult .NET Framework 2.0-s verziója esetén. Az osztály és a XmlReader metódus használatával létrehozhat egy érvényesítő XmlReaderSettings példánytCreate. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.

Ez a metódus beolvassa az elem tartalmát, binHex kódolással dekódolja, és visszaadja a dekódolt bináris bájtokat (például egy beágyazott BinHex kódolású GIF-képet) a pufferbe.

Ez a módszer csak egyszerű tartalomelemeket tud olvasni. Az elem tartalmazhat szöveget, szóközt, jelentős üres területet, CDATA-szakaszokat, megjegyzéseket és feldolgozási utasításokat. Olyan entitáshivatkozásokat is tartalmazhat, amelyek automatikusan ki vannak bontva. Az elem nem rendelkezhet gyermekelemekkel.

Ez a módszer nagyon hasonló a metódushoz, azzal a ReadContentAsBinHex kivételt leszámítva, hogy csak elemcsomópont-típusok esetén hívható meg.

Ha az count érték nagyobb, mint a dokumentum bájtjainak száma, vagy ha megegyezik a dokumentumban lévő bájtok számával, a XmlValidatingReader dokumentum összes fennmaradó bájtját beolvassa, és visszaadja az olvasott bájtok számát. A következő XmlValidatingReader metódushívás nullát ad vissza, és az olvasót a következő csomópontra EndElementhelyezi át.

Ha az összes elemtartalom felhasználása előtt hív meg Read , az olvasó úgy viselkedhet, mintha az első tartalmat használták volna fel, majd meghívták volna a Read metódust. Ez azt jelenti, hogy az olvasó az összes szöveget felolvassa, amíg a végelem nem jelenik meg. Ezután felolvassa a zárócímkecsomópontot, felolvassa a következő csomópontot, majd elhelyezi magát a következő csomóponton.

A következőre érvényes:

Lásd még