Udostępnij za pośrednictwem

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

  • Odwołanie

Definicja

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

Odczytuje element i dekoduje BinHex zawartość.

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ć 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

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

ArgumentOutOfRangeException

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

NotSupportedException

Implementacja XmlReader nie obsługuje tej metody.

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

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

Ta metoda może odczytywać tylko elementy prostej zawartości. Element może zawierać tekst, biały znak, istotne białe znaki, sekcje CDATA, komentarze i instrukcje przetwarzania. Może również zawierać odwołania do jednostek, które są automatycznie rozwijane. 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.

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

Jeśli wywołasz wywołanie Read przed użyciem całej zawartości elementu, czytnik może zachowywać się tak, jakby pierwsza zawartość została zużyta, a następnie Read została wywołana metoda. Oznacza to, że czytnik 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 umieszcza się w następnym następnym węźle.

Dotyczy

Zobacz też