派生クラスでオーバーライドされると、指定したバイナリ バイトを base64 としてエンコードし、その結果生成されるテキストを書き込みます。
Public MustOverride Sub WriteBase64( _
ByVal buffer() As Byte, _ ByVal index As Integer, _ ByVal count As Integer _)
[C#]
public abstract void WriteBase64(byte[] buffer,intindex,intcount);
[C++]
public: virtual void WriteBase64(unsigned charbuffer __gc[],intindex,intcount) = 0;
[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/) です。
使用例
このメソッドの使用例については、 XmlTextWriter.WriteBase64 のトピックを参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard