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

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

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

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é se má zkopírovat výsledný text. Tato hodnota nemůže být null.

index

Int32

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

count

Int32

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

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) aktuální uzel nepodporuje.

ArgumentOutOfRangeException

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

Poznámky

Poznámka

V rozhraní .NET Framework 2.0 se doporučuje vytvořit XmlReader instance pomocí XmlReaderSettings třídy a Create metody. To vám umožní plně využít všechny nové funkce zavedené v rozhraní .NET Framework. Další informace najdete v části Poznámky na stránce s odkazem XmlReader .

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

Poznámka

Mezi voláními metody byste neměli přistupovat k žádným z vlastností čtečky, ReadContentAsBinHex dokud metoda nevrátí hodnotu 0.

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

• ReadContentAsBinHex vrátí hodnotu 0, když dosáhl konce datového proudu bajtů, se kterou byl provozován. Čtenář je umístěn na prvním uzlu, který není obsahem.

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

• ReadContentAsBinHex Není podporován v následujících typech uzlů XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Viz také

• ReadElementContentAsBinHex(Byte[], Int32, Int32)
• ReadContentAsBase64(Byte[], Int32, Int32)