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

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Origine:: XmlWriter.cs

Origine:: XmlWriter.cs

Origine:: XmlWriter.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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:
 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)

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.

Si applica a

Condividi tramite