XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Metoda
Definicja
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ść Base64.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64 (byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParametry
- 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ść elementu buffer to null.
Bieżący węzeł nie jest węzłem elementu.
Indeks do buforu lub indeksu + liczba jest większy niż przydzielony rozmiar buforu.
Implementacja XmlTextReader nie obsługuje tej metody.
Element zawiera zawartość mieszaną.
Nie można przekonwertować zawartości na żądany typ.
Przykłady
Zobacz XmlReader.ReadElementContentAsBase64 , 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 kodowania Base64 i zwraca zdekodowane bajty binarne (na przykład wbudowany obraz GIF zakodowany w formacie Base64) do buforu. Aby uzyskać więcej informacji, zobacz RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies" (Wielozadaniowe rozszerzenia poczty internetowej). Dokumenty RFC można uzyskać z witryny sieci Web Żądania komentarzy.
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 ReadContentAsBase64 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.
