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

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Źródło:: XmlNodeReader.cs

Źródło:: XmlNodeReader.cs

Źródło:: XmlNodeReader.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Odczytuje zawartość i zwraca dekodowane bajty binarne 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[]

Bufor, do którego ma być skopiowany wynikowy tekst. Ta wartość nie może być nullwartością .

index: Int32

Przesunięcie do buforu, w którym chcesz rozpocząć kopiowanie wyniku.

count: Int32

Maksymalna liczba bajtów do skopiowania do buforu. Rzeczywista liczba skopiowanych bajtów jest zwracana z tej metody.

Zwraca

Int32

Liczba bajtów zapisanych w buforze.

Wyjątki

ArgumentNullException

Wartość elementu buffer to null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) nie jest obsługiwany w bieżącym węźle.

ArgumentOutOfRangeException

Indeks do buforu lub indeksu i liczby jest większy niż przydzielony rozmiar buforu.

Uwagi

Uwaga

W .NET Framework 2.0 zalecaną praktyką jest utworzenie XmlReader wystąpień przy użyciu XmlReaderSettings klasy i Create metody. Dzięki temu można w pełni wykorzystać wszystkie nowe funkcje wprowadzone w .NET Framework. Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ta metoda przesyła strumieniowo zawartość, dekoduje zawartość BinHex i zwraca zdekodowane bajty binarne (na przykład wbudowany obraz GIF zakodowany w tekście) do buforu. Tę metodę można wywołać kolejno, aby odczytywać duże strumienie osadzonego tekstu.

Uwaga

Nie należy uzyskiwać dostępu do żadnej właściwości czytnika między wywołaniami metody, ReadContentAsBinHex dopóki metoda nie zwróci wartości 0.

Ta metoda ma następujące zachowanie:

ReadContentAsBinHex Zwraca wartość 0 po osiągnięciu końca strumienia bajtów, na którego działa. Czytnik jest umieszczony w pierwszym węźle nienależące do zawartości.
Jeśli poprosisz o mniej lub dokładną liczbę bajtów niż pozostawiono w strumieniu, czytnik pozostaje w bieżącej pozycji.
ReadContentAsBinHex nie jest obsługiwany w następujących typach węzłów XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Dotyczy