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

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

Přečte element 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é se má zkopírovat výsledný text. Tato hodnota nemůže být null.

index

Int32

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

count

Int32

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

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 elementu.

ArgumentOutOfRangeException

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

XmlException

Element 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

Poznámka

V rozhraní .NET Framework 2.0 se doporučuje vytvořit XmlReader instance pomocí XmlReaderSettings třídy a Create metody. To vám umožní plně využít všechny nové funkce zavedené v rozhraní .NET Framework. Další informace najdete v části Poznámky na stránce s odkazem XmlReader .

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 s kódováním Base64) do vyrovnávací paměti. Další informace najdete v dokumentu RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanism for Specifying and Popising the Format of Internet Message Bodies( Dokumenty RFC můžete získat z webu Žádosti o komentáře.

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

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ětší než počet bajtů v dokumentu nebo pokud 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ů. ReadElementContentAsBase64 Další volání metody vrátí nulu a přesune čtenáře do uzlu za EndElement uzlem.

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

Viz také

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