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

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
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ść elementu buffer to null.

InvalidOperationException

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

ArgumentOutOfRangeException

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

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 przesyła strumieniowo zawartość, dekoduje Base64 zawartość i zwraca zdekodowane 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 tekstu osadzonego. 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.

Uwaga

Nie należy uzyskiwać dostępu do żadnych 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 niezwiązanym z zawartością.

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

  • ReadContentAsBase64Nie jest obsługiwany w następujących typach węzłów XML: Element, XmlDeclaration, None, DocumentType``Document, Notation, Entity. DocumentFragment

Dotyczy

Zobacz też