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

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlValidatingReader.cs

Přečte obsah a vrátí binární bajty dekódované binHexem.

public:
 override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadContentAsBinHex(byte[] buffer, int index, int count);

override this.ReadContentAsBinHex : byte[] * int * int -> int

Public Overrides Function ReadContentAsBinHex (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 je vrácen z této metody.

Návraty

Int32

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

Výjimky

ArgumentNullException

Hodnota buffer je null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) na aktuálním uzlu se nepodporuje.

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 XmlValidatingReader tuto metodu nepodporuje.

Poznámky

Note

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

Tato metoda streamuje obsah, dekóduje obsah BinHex a vrátí dekódované binární bajty (například vložený obrázek BINHex kódovaný gif) do vyrovnávací paměti. Tuto metodu lze volat postupně ke čtení velkých datových proudů vloženého textu.

Note

Neměli byste přistupovat k žádné vlastnosti čtenáře mezi voláními ReadContentAsBinHex metody, dokud metoda nevrátí hodnotu 0.

Tato metoda má následující chování:

• ReadContentAsBinHex vrátí hodnotu 0, když dosáhla konce bajtového datového proudu, na které fungoval. Čtenář se umístí na první uzel bez obsahu.

• Pokud požádáte o méně bajtů nebo přesný počet bajtů, než je ponecháno ve streamu, čtenář zůstane v aktuální pozici.

• ReadContentAsBinHex nepodporuje následující typy uzlů XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity a DocumentFragment.

Viz také

• XmlReader
• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• XmlNodeType