XmlWriter.WriteBase64(Byte[], Int32, Int32) Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlWriter.cs

Quando substituído em uma classe derivada, codifica os bytes binários especificados como Base64 e grava o texto resultante.

public:
 abstract void WriteBase64(cli::array <System::Byte> ^ buffer, int index, int count);

public abstract void WriteBase64 (byte[] buffer, int index, int count);

abstract member WriteBase64 : byte[] * int * int -> unit

Public MustOverride Sub WriteBase64 (buffer As Byte(), index As Integer, count As Integer)

Parâmetros

buffer

Byte[]

Matriz de bytes a ser codificada.

index

Int32

A posição no buffer que indica o início dos bytes a serem gravados.

count

Int32

O número de bytes a serem gravados.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é menor que zero.

- ou -

O tamanho do buffer menos index é menor que count.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir usa o WriteBase64 método para gravar Base64 dados. Os Base64 dados são inseridos em um <image> elemento .

public static void Base64EncodeImageFile() {

  int bufferSize = 1000;
  byte[] buffer = new byte[bufferSize];
  int readBytes = 0;
    
  using (XmlWriter writer = XmlWriter.Create("output.xml")) {

       FileStream inputFile = new FileStream(@"C:\artFiles\sunset.jpg",
                                                                    FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read);
       writer.WriteStartDocument();
       writer.WriteStartElement("image");
       BinaryReader br = new BinaryReader(inputFile);
       Console.WriteLine("\r\nWriting Base64 data...");

       do {
          readBytes = br.Read(buffer, 0, bufferSize);
          writer.WriteBase64(buffer, 0, readBytes);
       } while (bufferSize <= readBytes);
       br.Close();
        
    writer.WriteEndElement();// </image>
    writer.WriteEndDocument();
  }
}

Public Shared Sub Base64EncodeImageFile() 
    
    Dim bufferSize As Integer = 1000
    Dim buffer(bufferSize) As Byte
    Dim readBytes As Integer = 0
    
    Using writer As XmlWriter = XmlWriter.Create("output.xml")

            Dim inputFile As New FileStream("C:\artFiles\sunset.jpg", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
            writer.WriteStartDocument()
            writer.WriteStartElement("image")
            Dim br As New BinaryReader(inputFile)
            Console.WriteLine(vbCr + vbLf + "Writing Base64 data...")
            
            Do
                readBytes = br.Read(buffer, 0, bufferSize)
                writer.WriteBase64(buffer, 0, readBytes)
            Loop While bufferSize <= readBytes
            br.Close()
        
        writer.WriteEndElement() ' </image>
        writer.WriteEndDocument()

    End Using
 
End Sub

Comentários

Por exemplo, o buffer de bytes pode conter o conteúdo binário de uma imagem GIF. Isso claramente não seria um XML válido. A Base64 codificação foi projetada para representar sequências de bytes arbitrárias em um formulário de texto composto pelos 65 caracteres US-ASCII ([A-Za-z0-9+/=]) em que cada caractere codifica 6 bits dos dados binários. Para obter mais informações, consulte Solicitações de Comentários (RFC) 1521 localizada no site Solicitação de Comentários.

Para obter a versão assíncrona desse método, consulte WriteBase64Async.