Sdílet prostřednictvím


XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Metoda

Definice

Přečte prvek a dekóduje obsah BinHex.

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

Parametry

buffer
Byte[]

Vyrovnávací paměť, do které chcete výsledný text zkopírovat. Tato hodnota nemůže být null.

index
Int32

Posun do vyrovnávací paměti, kde začít kopírovat výsledek.

count
Int32

Maximální počet bajtů, které se mají zkopírovat do vyrovnávací paměti. Skutečný počet bajtů zkopírovaných z této metody se vrátí.

Návraty

Int32

Počet bajtů zapsaných do vyrovnávací paměti.

Výjimky

Hodnota buffer je null.

Aktuální uzel není uzel prvku.

Index do vyrovnávací paměti nebo indexu + počet je větší než přidělená velikost vyrovnávací paměti.

Element obsahuje smíšený obsah.

Obsah nelze převést na požadovaný typ.

Příklady

Podívejte XmlReader.ReadElementContentAsBinHex se na příklad použití této metody.

Poznámky

Poznámka

V .NET Framework 2.0 doporučujeme vytvořit XmlReader instance pomocí XmlReaderSettings třídy a Create metody. Díky tomu můžete plně využít všechny nové funkce představené v .NET Framework. Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda čte obsah elementu, dekóduje ho pomocí kódování BinHex a vrátí dekódované binární bajty (například vložený obrázek BinHex s kódováním GIF) do vyrovnávací paměti.

Tato metoda může číst pouze elementy jednoduchého obsahu. Prvek může obsahovat text, prázdné znaky, významné prázdné znaky, oddíly CDATA, komentáře a pokyny ke zpracování. Může také obsahovat odkazy na entity, které se automaticky rozbalí. Element nemůže mít podřízené prvky.

Tato metoda je velmi podobná ReadContentAsBinHex metodě s tím rozdílem, že ji lze volat pouze u typů uzlů elementů.

Pokud je hodnota počtu v dokumentu vyšší než počet bajtů nebo je rovna počtu bajtů v dokumentu, XmlNodeReader přečte všechny zbývající bajty v dokumentu a vrátí počet přečtených bajtů. Další XmlNodeReader volání metody vrátí nulu a přesune čtenáře na uzel, který následuje za EndElement uzlem.

Pokud voláte Read před spotřebou veškerého obsahu elementu, může se čtenář chovat, jako by byl první obsah spotřebován a pak Read byla volána metoda. To znamená, že čtenář přečte celý text, dokud se neskončí koncový prvek. Pak přečte uzel koncové značky, přečte další uzel a pak se umístí na další další uzel.

Platí pro

Viz také