Udostępnij za pośrednictwem

XmlNodeReader.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:
 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ć 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.

ArgumentOutOfRangeException

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

Uwagi

Uwaga

W .NET Framework 2.0 zalecaną praktyką jest utworzenie XmlReader wystąpień przy użyciu XmlReaderSettings klasy i Create metody. Dzięki temu można w pełni wykorzystać wszystkie nowe funkcje wprowadzone w .NET Framework. Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

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

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.

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

Dotyczy

Zobacz też