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

  • Reference

Definice

Obor názvů:
System.Xml
Sestavení:
System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.dll
Sestavení:
netstandard.dll

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

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex (byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (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

ArgumentNullException

Hodnota buffer je null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) není na aktuálním uzlu podporován.

-nebo-

XmlReader Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

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

Poznámky

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

Poznámka

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 datového proudu bajtů, na které fungoval. Čtenář je umístěn na prvním uzlu 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 ve své aktuální pozici.

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

Asynchronní verze této metody naleznete v tématu ReadContentAsBinHexAsync.

Platí pro

Viz také