XmlWriter.WriteBinHex(Byte[], Int32, Int32) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XmlWriter.cs

Quando sottoposto a override in una classe derivata, codifica i byte binari specificati come valori BinHex e scrive il testo risultante.

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

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

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

Public Overridable Sub WriteBinHex (buffer As Byte(), index As Integer, count As Integer)

Parametri

buffer

Byte[]

Matrice di byte da codificare.

index

Int32

Posizione nel buffer che indica l'inizio dei byte da scrivere.

count

Int32

Numero di byte da scrivere.

Eccezioni

ArgumentNullException

buffer è null.

InvalidOperationException

Il writer è chiuso o nello stato di errore. -oppure-

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

ArgumentOutOfRangeException

index o count è minore di zero.

-oppure-

La lunghezza del buffer meno index è minore di count.

Esempio

Nell'esempio seguente viene usato il WriteBinHex metodo per scrivere BinHex dati. I BinHex dati vengono incorporati all'interno di un <image> elemento.

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

Commenti

Per la versione asincrona di questo metodo, vedere WriteBinHexAsync.