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

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReader.cs

Přečte obsah a vrátí dekódované binární bajty 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[]

Vyrovnávací paměť, do které chcete zkopírovat výsledný text. Tato hodnota nemůže být null.

index

Int32

Posun do vyrovnávací paměti, kde začít kopírovat výsledek.

count

Int32

Maximální počet bajtů, které se mají zkopírovat do vyrovnávací paměti. Skutečný počet bajtů zkopírovaných je vrácen z této metody.

Návraty

Int32

Počet bajtů zapsaných do vyrovnávací paměti.

Výjimky

ArgumentNullException

Hodnota buffer je null.

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) na aktuálním uzlu se nepodporuje.

nebo

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

ArgumentOutOfRangeException

Index do vyrovnávací paměti nebo indexu + počet je větší než přidělená velikost vyrovnávací paměti.

NotSupportedException

Implementace XmlReader tuto metodu nepodporuje.

Poznámky

Tato metoda streamuje obsah, dekóduje Base64 obsah a vrátí dekódované binární bajty (například vložený Base64 zakódovaný obrázek GIF) do vyrovnávací paměti. Tuto metodu lze volat postupně ke čtení velkých datových proudů vloženého textu. Další informace naleznete v dokumentu RFC 1521, "MIME (Multipurpose Internet Mail Extensions) část 1: Mechanismy pro určení a popis formátu obsahu internetových zpráv". RfCs můžete získat z webu Požadavek pro komentáře.

Note

Neměli byste přistupovat k žádné vlastnosti čtenáře mezi voláními ReadContentAsBase64 metody, dokud metoda nevrátí hodnotu 0.

Tato metoda má následující chování:

• ReadContentAsBase64 vrátí hodnotu 0 , když dosáhla konce bajtového datového proudu, na které fungoval. Čtenář se umístí na první uzel bez obsahu.

• Pokud požádáte o méně bajtů nebo přesný počet bajtů, než zbývá v datovém proudu, zůstane čtenář ve své aktuální pozici.

• ReadContentAsBase64nepodporuje následující typy uzlů XML: , , , , , , Element, , XmlDeclaration. None. DocumentDocumentTypeNotationEntityDocumentFragment

Asynchronní verzi této metody naleznete v tématu ReadContentAsBase64Async.

Viz také

• ReadElementContentAsBase64(Byte[], Int32, Int32)
• XmlNodeType