XmlReader.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 dekodowane bajty binarne base64.

public:
 virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);
abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overridable 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ć 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

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

-lub-

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentOutOfRangeException

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

NotSupportedException

Implementacja XmlReader nie obsługuje tej metody.

Uwagi

Ta metoda przesyła strumieniowo zawartość, dekoduje Base64 zawartość i zwraca dekodowane bajty binarne (na przykład Base64 wbudowany obraz GIF) 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: Mechanizmy określania i opisywania formatu treści wiadomości internetowych". Możesz uzyskać rfCs z witryny sieci Web Request for Comments.

Uwaga

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

Ta metoda ma następujące zachowanie:

  • ReadContentAsBase64 zwraca wartość 0 po osiągnięciu końca strumienia bajtów, na którego działa. Czytnik jest umieszczony w pierwszym węźle nienależące do zawartości.

  • Jeśli poprosisz o mniej lub dokładną liczbę bajtów niż pozostawiono w strumieniu, czytnik pozostaje 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

Aby uzyskać asynchroniczną wersję tej metody, zobacz ReadContentAsBase64Async.

Dotyczy

Zobacz też