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

  • Reference

Definice

Obor názvů:
System.Xml
Sestavení:
System.Xml.ReaderWriter.dll
Sestavení:
System.Xml.dll
Sestavení:
netstandard.dll

Přečte obsah a vrátí Base64 dekódované binární bajty.

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[]

Vyrovnávací paměť, do které chcete výsledný text zkopírovat. 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 z této metody se vrátí.

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) není podporován v aktuálním uzlu.

ArgumentOutOfRangeException

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

Poznámky

Poznámka

Počínaje rozhraním .NET Framework 2.0 doporučujeme vytvářet XmlReader instance pomocí XmlReader.Create metody, abyste mohli využívat nové funkce.

Tato metoda streamuje obsah, dekóduje Base64 obsah a vrátí dekódované binární bajty (například vložený Base64obrázek GIF s kódováním) 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". Dokumenty RFC můžete získat z webu Požadavek na komentáře.

Poznámka

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 bajtů datového proudu, na které fungoval. Čtenář je umístěn na prvním uzlu bez obsahu.

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

  • ReadContentAsBase64nepodporuje následující typy uzlů XML: Element, , XmlDeclaration, Document``None, DocumentType, Notation, , Entity. DocumentFragment. .

Platí pro

Viz také