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

Definição

Quando substituído em uma classe derivada, codifica os bytes binários especificados como BinHex e grava o texto resultante.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

public:
 virtual void WriteBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public:
 abstract void WriteBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual void WriteBinHex (byte[] buffer, int index, int count);
public abstract void WriteBinHex (byte[] buffer, int index, int count);
abstract member WriteBinHex : byte[] * int * int -> unit
override this.WriteBinHex : byte[] * int * int -> unit
abstract member WriteBinHex : byte[] * int * int -> unit
Public Overridable Sub WriteBinHex (buffer As Byte(), index As Integer, count As Integer)
Public MustOverride Sub WriteBinHex (buffer As Byte(), index As Integer, count As Integer)

Parâmetros

buffer
Byte[]

Matriz de bytes a ser codificada.Byte array to encode.

index
Int32

A posição no buffer que indica o início dos bytes a serem gravados.The position in the buffer indicating the start of the bytes to write.

count
Int32

O número de bytes a serem gravados.The number of bytes to write.

Exceções

buffer é null.buffer is null.

O gravador está fechado ou em estado de erro.The writer is closed or in error state. - ou --or-

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

index ou count é menor que zero.index or count is less than zero.

- ou --or- O tamanho do buffer menos index é menor que count.The buffer length minus index is less than count.

Exemplos

O exemplo a seguir usa o WriteBinHex método para gravar BinHex dados.The following example uses the WriteBinHex method to write BinHex data. Os BinHex dados são inseridos dentro de um <image> elemento.The BinHex data is embedded within an <image> element.


public static void BinHexEncodeImageFile() {

  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 BinHex data...");

       do {
          readBytes = br.Read(buffer, 0, bufferSize);
          writer.WriteBinHex(buffer, 0, readBytes);
       } while (bufferSize <= readBytes);
       br.Close();

    writer.WriteEndElement();// </image>
    writer.WriteEndDocument();
  }
}
Public Shared Sub BinHexEncodeImageFile() 
    
    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 BinHex data...")
            
            Do
                readBytes = br.Read(buffer, 0, bufferSize)
                writer.WriteBinHex(buffer, 0, readBytes)
            Loop While bufferSize <= readBytes
            br.Close()

        writer.WriteEndElement() ' </image>
        writer.WriteEndDocument()

    End Using
 
End Sub

Comentários

Para obter a versão assíncrona desse método, consulte WriteBinHexAsync .For the asynchronous version of this method, see WriteBinHexAsync.

Aplica-se a