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

Definicja

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

Odczytuje zawartość i zwraca Base64 zdekodowane bajty binarne.

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBase64(byte[] buffer, int index, int count);
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overrides Function ReadContentAsBase64 (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ść buffer to null.

InvalidOperationException

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

ArgumentOutOfRangeException

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

Uwagi

Note

Zalecamy utworzenie wystąpień XmlReader przy użyciu metody XmlReader.Create, aby korzystać z nowych funkcji.

Ta metoda przesyła strumieniowo zawartość, dekoduje Base64 zawartość i zwraca dekodowane bajty binarne (na przykład wbudowany obraz GIF zakodowany w tekście Base64) do buforu. Tę metodę można wywołać kolejno, aby odczytywać duże strumienie osadzonego tekstu. 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". Dokumenty RFC można uzyskać z witryny sieci Web Request for Comments.

Note

Nie należy uzyskiwać dostępu do żadnej właściwości czytnika między wywołaniami ReadContentAsBase64 metody, dopóki metoda nie zwróci wartości 0.

Ta metoda ma następujące zachowanie:

  • ReadContentAsBase64 Zwraca wartość 0, gdy osiągnęła koniec strumienia bajtów, na którego działa. Czytnik jest umieszczony w pierwszym węźle innej niż zawartość.

  • Jeśli poprosisz o mniejszą lub dokładną liczbę bajtów niż pozostawione w strumieniu, czytnik pozostanie w bieżącej pozycji.

  • ReadContentAsBase64nie jest obsługiwany w następujących typach węzłów XML: Element, , XmlDeclaration, DocumentTypeNoneNotationDocument, , . DocumentFragmentEntity

Dotyczy

Zobacz też