XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beolvassa az elemet, és dekódolja a Base64-tartalmat.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParamé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 XmlTextReader 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.
Példák
Tekintse meg XmlReader.ReadElementContentAsBase64 a metódust használó példát.
Megjegyzések
Note
Javasoljuk, hogy az új funkciók kihasználásához hozzon létre XmlReader példányokat a XmlReader.Create metódus használatával.
Ez a metódus beolvassa az elem tartalmát, base64 kódolással dekódolja, és visszaadja a dekódolt bináris bájtokat (például egy beágyazott Base64 kódolású GIF-képet) a pufferbe. További információ: RFC 1521, "MIME (Többcélú internetes levelezési bővítmények) Első rész: Az internetes üzenettörzsek formátumának meghatározására és leírására szolgáló mechanizmusok". Az RFC-ket a Megjegyzések kérése webhelyről szerezheti be.
Ez a módszer csak egyszerű tartalomelemeket tud olvasni. Az elem tartalmazhat szöveget, szóközt, jelentős szabad 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ít a metódushoz, azzal a ReadContentAsBase64 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 XmlTextReader dokumentum összes fennmaradó bájtját beolvassa, és visszaadja az olvasott bájtok számát. A következő XmlTextReader 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ó beolvassa az összes szöveget, amíg a végelem nem jelenik meg. Ezután beolvassa a zárócímkecsomópontot, beolvassa a következő csomópontot, majd elhelyezi magát a következő csomóponton.
