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

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 zkopírovat výsledný text. 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

ArgumentNullException

Hodnota buffer je null.

InvalidOperationException

Aktuální uzel není uzel elementu.

ArgumentOutOfRangeException

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

NotSupportedException

Implementace tuto metodu XmlValidatingReader nepodporuje.

XmlException

Prvek obsahuje smíšený obsah.

FormatException

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

Poznámky

Poznámka

Třída XmlValidatingReader je zastaralá v rozhraní .NET Framework 2.0. Ověřování instance můžete vytvořit XmlReader pomocí XmlReaderSettings třídy a Create metody. Další informace najdete v části Poznámky referenční XmlReader stránky.

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 jednoduché prvky 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í. Prvek nemůže obsahovat podřízené prvky.

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

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

Pokud zavoláte Read před spotřebou veškerého obsahu elementu, může se čtenář chovat, jako kdyby byl první obsah spotřebován a pak Read byla volána metoda. To znamená, že čtenář přečte celý text, dokud se nezobrazí 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