XmlValidatingReader.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ć wartością null.

index
Int32

Przesunięcie do buforu, w którym należy 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ść 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.

Implementacja XmlValidatingReader nie obsługuje tej metody.

Uwagi

Note

Klasa XmlValidatingReader jest przestarzała w programie .NET Framework 2.0. Wystąpienie weryfikacji XmlReader można utworzyć przy użyciu XmlReaderSettings klasy i Create metody . 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 formacie BinHex) do buforu. Tę metodę można wywołać kolejno, aby odczytywać duże strumienie osadzonego tekstu.

Note

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

Ta metoda ma następujące zachowanie:

  • ReadContentAsBinHex Zwraca wartość 0, gdy osiągnęła koniec strumienia bajtów, na którego działa. Czytnik jest umieszczony w pierwszym węźle innej niż zawartość.

  • Jeśli poprosisz o mniejszą lub dokładną liczbę bajtów niż pozostawione w strumieniu, czytnik pozostanie 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 i DocumentFragment.

Dotyczy

Zobacz też