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

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReader.cs

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

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

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

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

Public Overridable 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.

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.

XmlException

Prvek obsahuje smíšený obsah.

FormatException

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

Příklady

Následující příklad přečte vložený Base64 kódovaný obrázek. Data Base64 jsou vložena do elementu <image> . A BinaryWriter slouží k vytvoření nového binárního datového souboru.

public static void Base64DecodeImageFile() {

  byte[] buffer = new byte[1000];
  int readBytes = 0;

  using (XmlReader reader = XmlReader.Create("output.xml")) {
                    
        FileStream outputFile = new FileStream(@"C:\artFiles\data\newImage.jpg",
                    FileMode.OpenOrCreate, FileAccess.Write, FileShare.Write);
        // Read to the image element.
        reader.ReadToFollowing("image");
        // Read the Base64 data.
        Console.WriteLine("\r\nReading Base64...");
        BinaryWriter bw = new BinaryWriter(outputFile);
        while ((readBytes = reader.ReadElementContentAsBase64(buffer, 0, 50))>0) {
            bw.Write(buffer, 0, readBytes);
        }
        outputFile.Close();
  }
}

Public Shared Sub Base64DecodeImageFile() 
    
    Dim buffer(999) As Byte
    Dim readBytes As Integer = 0
    
    Using reader As XmlReader = XmlReader.Create("output.xml")

            Dim outputFile As New FileStream("C:\artFiles\data\newImage.jpg", FileMode.OpenOrCreate, FileAccess.Write, FileShare.Write)
            ' Read to the image element.
            reader.ReadToFollowing("image")
            ' Read the Base64 data.
            Console.WriteLine(vbCr + vbLf + "Reading Base64...")
            Dim bw As New BinaryWriter(outputFile)
            readBytes = reader.ReadElementContentAsBase64(buffer, 0, 50)
            While (readBytes > 0)
                bw.Write(buffer, 0, readBytes)
                readBytes = reader.ReadElementContentAsBase64(buffer, 0, 50)
            End While
            outputFile.Close()
        
    End Using

End Sub

Poznámky

Tato metoda čte obsah elementu, dekóduje ho pomocí Base64 kódování 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. 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.

ReadElementContentAsBase64 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ů.

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

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 celý text, dokud se neskončí koncový prvek. Pak přečte uzel koncové značky, přečte další uzel a pak se umístí do dalšího dalšího uzlu.

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

Viz také

• ReadContentAsBase64(Byte[], Int32, Int32)