XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlNodeReader.cs

Přečte prvek a dekóduje obsah Base64.

public:
 override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);

override this.ReadElementContentAsBase64 : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBase64 (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

Aktuální uzel není uzel prvku.

ArgumentOutOfRangeException

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

XmlException

Prvek obsahuje smíšený obsah.

FormatException

Obsah nelze převést na požadovaný typ.

Příklady

Podívejte XmlReader.ReadElementContentAsBase64 se na příklad použití této metody.

Poznámky

Note

Pokud chcete využívat novější funkce, doporučeným postupem je vytvoření XmlReader instancí pomocí XmlReaderSettings třídy a Create metody. Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda čte obsah, dekóduje ho pomocí kódování Base64 a vrátí dekódované binární bajty (například vložený obrázek GIF kódovaný jako Base64) do vyrovnávací paměti. 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.

Tato metoda může číst pouze prvky jednoduchého obsahu. Prvek může obsahovat text, prázdné znaky, významné prázdné znaky, oddíly CDATA, komentáře a pokyny ke zpracování. Může také obsahovat odkazy na entity, které se automaticky rozbalí. Element nemůže obsahovat podřízené prvky.

Tato metoda je velmi podobná metodě s tím rozdílem ReadContentAsBase64 , že ji lze volat pouze u typů uzlů elementů.

Pokud je hodnota počtu v dokumentu vyšší než počet bajtů nebo se rovná počtu bajtů v dokumentu, XmlNodeReader přečte všechny zbývající bajty v dokumentu a vrátí počet přečtených bajtů. Volání další ReadElementContentAsBase64 metody vrátí nulu a přesune čtenáře na uzel za EndElement uzlem.

Pokud voláte Read před spotřebou veškerého obsahu elementu, může se čtenář chovat, jako kdyby byl první obsah spotřebován a pak Read byla volána metoda. To znamená, že čtenář přečte veškerý text, dokud se neskončí koncový prvek. Pak přečte uzel koncové značky, přečte další uzel a pak se umístí na další další uzel.

Viz také

• ReadContentAsBase64(Byte[], Int32, Int32)
• ReadElementContentAsBinHex(Byte[], Int32, Int32)