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

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Codiert beim Überschreiben in einer abgeleiteten Klasse die angegebenen binären Bytes als BinHex und schreibt den resultierenden Text.

C#

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

C#

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

Parameter

buffer

Byte[]

Zu codierendes Bytearray.

index

Int32

Die Position innerhalb des Puffers, die den Anfang der zu schreibenden Bytes kennzeichnet.

count

Int32

Die Anzahl der zu schreibenden Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

InvalidOperationException

Der Writer ist geschlossen oder befindet sich im Fehlerzustand. - oder -

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

ArgumentOutOfRangeException

index oder count ist kleiner als 0.

- oder - Die Pufferlänge minus index ist kleiner als count.

Beispiele

Im folgenden Beispiel wird die WriteBinHex Methode zum Schreiben BinHex von Daten verwendet. Die BinHex Daten werden in ein <image> Element eingebettet.

C#

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();
  }
}

Hinweise

Die asynchrone Version dieser Methode finden Sie unter WriteBinHexAsync.

Gilt für