XmlWriter.WriteBinHex(Byte[], Int32, Int32) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

派生クラスでオーバーライドされると、指定されたバイナリ バイトを BinHex としてエンコードし、その結果生成されるテキストを書き込みます。

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)

パラメーター

buffer

Byte[]

エンコードするバイト配列。

index

Int32

書き込むバイトの開始を示すバッファー内の位置。

count

Int32

書き込むバイト数。

例外

ArgumentNullException

buffer が nullです。

InvalidOperationException

ライターが閉じているかエラー状態です。 - または -

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentOutOfRangeException

index または count が 0 未満です。

- または -

バッファーの長さから index を引いた値が count 未満です。

例

次の例では、 メソッドを WriteBinHex 使用してデータを書き込 BinHex みます。 データは BinHex 要素内に <image> 埋め込まれます。

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

注釈

このメソッドの非同期バージョンについては、「」を参照してください WriteBinHexAsync。