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

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

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 element i dekoduje zawartość BinHex.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);

override this.ReadElementContentAsBinHex : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBinHex (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

Bieżący węzeł nie jest węzłem elementu.

ArgumentOutOfRangeException

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

XmlException

Element zawiera zawartość mieszaną.

FormatException

Nie można przekonwertować zawartości na żądany typ.

Przykłady

Zobacz XmlReader.ReadElementContentAsBinHex , aby zobaczyć przykład przy użyciu tej metody.

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 odczytuje zawartość elementu, dekoduje ją przy użyciu kodowania BinHex i zwraca dekodowane bajty binarne (na przykład wbudowany obraz GIF zakodowany w tekście BinHex) do buforu.

Ta metoda może odczytywać tylko elementy prostej zawartości. Element może zawierać tekst, biały odstęp, istotne odstępy, sekcje CDATA, komentarze i instrukcje przetwarzania. Może również zawierać odwołania do jednostek, które są automatycznie rozwinięte. Element nie może mieć elementów podrzędnych.

Ta metoda jest bardzo podobna ReadContentAsBinHex do metody, z tą różnicą, że może być wywoływana tylko w typach węzłów elementów.

Jeśli wartość licznika jest większa niż liczba bajtów w dokumencie lub jeśli jest równa liczbie bajtów w dokumencie, XmlNodeReader odczytuje wszystkie pozostałe bajty w dokumencie i zwraca liczbę odczytanych bajtów. Następne XmlNodeReader wywołanie metody zwraca zero i przenosi czytnik do węzła po węźle EndElement .

Jeśli wywołasz wywołanie Read przed użyciem całej zawartości elementu, czytelnik może zachowywać się tak, jakby pierwsza zawartość została zużyta, a następnie Read wywołana została metoda. Oznacza to, że czytelnik odczytuje cały tekst do momentu napotkania elementu końcowego. Następnie odczytuje węzeł tagu końcowego, odczytuje następny węzeł, a następnie umieść się w następnym następnym węźle.

Dotyczy