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

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll

Odczytuje zawartość i zwraca BinHex zdekodowane bajty binarne.

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[]

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.

-lub-

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentOutOfRangeException

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

NotSupportedException

Implementacja XmlReader nie obsługuje tej metody.

Uwagi

Ta metoda przesyła strumieniowo zawartość, dekoduje BinHex zawartość i zwraca dekodowane bajty binarne (na przykład BinHex wbudowany obraz GIF) 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.

  • ReadContentAsBinHexnie jest obsługiwany w następujących typach węzłów XML: Element, XmlDeclaration, None, DocumentType``Document, , Notation, Entity, DocumentFragment.

Aby uzyskać asynchroniczną wersję tej metody, zobacz ReadContentAsBinHexAsync.

Dotyczy

Zobacz też