XmlTextReader.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:
 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

Int32

Liczba bajtów zapisanych w buforze.

Wyjątki

ArgumentNullException

Wartość elementu buffer to null.

InvalidOperationException

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

ArgumentOutOfRangeException

Indeks do buforu lub indeksu + liczba jest większy niż przydzielony rozmiar buforu.

NotSupportedException

Implementacja XmlTextReader nie obsługuje tej metody.

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, zalecamy utworzenie XmlReader wystąpień przy użyciu XmlReader.Create metody , aby korzystać z nowych funkcji.

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

Uwaga

Nie należy uzyskiwać dostępu do żadnych 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 niezwiązanym z zawartością.

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

Dotyczy

Zobacz też