Udostępnij za pośrednictwem


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

Definicja

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

Liczba bajtów zapisanych w buforze.

Wyjątki

Wartość elementu buffer to null.

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

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

Zobacz też