XmlWriter.WriteBase64 メソッド

.NET Framework クラス ライブラリ リファレンス

XmlWriter.WriteBase64 メソッド

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 WriteBase64 ( _
    buffer As Byte(), _
    index As Integer, _
    count As Integer _
)

Visual Basic (使用法)

Dim instance As XmlWriter
Dim buffer As Byte()
Dim index As Integer
Dim count As Integer

instance.WriteBase64(buffer, index, count)

C#

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

C++

public:
virtual void WriteBase64 (
    array<unsigned char>^ buffer, 
    int index, 
    int count
) abstract

J#

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

JScript

public abstract function WriteBase64 (
    buffer : byte[], 
    index : int, 
    count : int
)

パラメータ

buffer

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

index

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

count

書き込むバイト数。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentException	バッファ長から index を差し引いた値が count より小さい値です。
ArgumentOutOfRangeException	index または count が 0 未満です。

解説

たとえば、バイト バッファに GIF イメージのバイナリ コンテンツが含まれることがあります。これは、明らかに有効な XML ではありません。Base64 エンコーディングは、任意のバイト シーケンスを 65 の US-ASCII 文字 ([A-Za-z0-9+/=]) で構成されるテキスト形式で表すようにデザインされています。ここで、各文字は、6 ビットのバイナリ データをエンコードします。詳細については、RFC (Requests for Comments) 1521 を参照してください。RFC は、"the Request for Comments" Web サイト (http://www.rfc-editor.org/) です。

使用例

WriteBase64 メソッドを使用して、Base64 データを書き込む例を次に示します。Base64 データは、<image> 要素内に埋め込まれます。

Visual Basic

Public Shared Sub Base64EncodeImageFile()
 
    
    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 Base64 data...")
            
            Do
                readBytes = br.Read(buffer, 0, bufferSize)
                writer.WriteBase64(buffer, 0, readBytes)
            Loop While bufferSize <= readBytes
            br.Close()
        
        writer.WriteEndElement() ' </image>
        writer.WriteEndDocument()

    End Using
 
End Sub 'Base64EncodeImageFile

C#

public static void Base64EncodeImageFile()
 {

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

       do {
          readBytes = br.Read(buffer, 0, bufferSize);
          writer.WriteBase64(buffer, 0, readBytes);
       } while (bufferSize <= readBytes);
       br.Close();
        
    writer.WriteEndElement();// </image>
    writer.WriteEndDocument();
        
  }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方