Udostępnij za pośrednictwem

XmlValidatingReader.ReadElementContentAsBase64(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 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 -> int
Public Overrides Function ReadElementContentAsBase64 (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 + liczba jest większy niż przydzielony rozmiar buforu.

NotSupportedException

Implementacja XmlValidatingReader nie obsługuje tej metody.

XmlException

Element zawiera zawartość mieszaną.

FormatException

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

Uwagi

Uwaga

Klasa XmlValidatingReader jest przestarzała w .NET Framework 2.0. Wystąpienie sprawdzania poprawności XmlReader można utworzyć przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

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, XmlValidatingReader odczytuje wszystkie pozostałe bajty w dokumencie i zwraca liczbę odczytanych bajtów. Następne XmlValidatingReader 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 odczyta 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 pozycjonuje się w następnym kolejnym węźle.

Dotyczy

Zobacz też