ToBase64Transform.TransformBlock メソッド

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

ToBase64Transform.TransformBlock メソッド

入力バイト配列の指定した領域を base 64 に変換し、その結果を出力バイト配列の指定した領域にコピーします。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function TransformBlock ( _
    inputBuffer As Byte(), _
    inputOffset As Integer, _
    inputCount As Integer, _
    outputBuffer As Byte(), _
    outputOffset As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As ToBase64Transform
Dim inputBuffer As Byte()
Dim inputOffset As Integer
Dim inputCount As Integer
Dim outputBuffer As Byte()
Dim outputOffset As Integer
Dim returnValue As Integer

returnValue = instance.TransformBlock(inputBuffer, inputOffset, inputCount, outputBuffer,
 outputOffset)

C#

public int TransformBlock (
    byte[] inputBuffer,
    int inputOffset,
    int inputCount,
    byte[] outputBuffer,
    int outputOffset
)

C++

public:
virtual int TransformBlock (
    array<unsigned char>^ inputBuffer, 
    int inputOffset, 
    int inputCount, 
    array<unsigned char>^ outputBuffer, 
    int outputOffset
) sealed

J#

public final int TransformBlock (
    byte[] inputBuffer, 
    int inputOffset, 
    int inputCount, 
    byte[] outputBuffer, 
    int outputOffset
)

JScript

public final function TransformBlock (
    inputBuffer : byte[], 
    inputOffset : int, 
    inputCount : int, 
    outputBuffer : byte[], 
    outputOffset : int
) : int

パラメータ

inputBuffer

base 64 に変換する入力。

inputOffset

入力バイト配列内のデータの使用開始位置を示すオフセット。

inputCount

データとして使用する入力バイト配列内のバイト数。

outputBuffer

結果を書き込む先の出力。

outputOffset

データの書き込みの開始位置を示す出力バイト配列内のオフセット。

戻り値
書き込むバイト数。

例外

例外の種類	条件
ObjectDisposedException	現在の ToBase64Transform は既に破棄されています。
CryptographicException	データ サイズが有効ではありません。

解説

ToBase64Transform クラスは、3 バイトの入力ブロックを処理し、4 バイトの出力ブロックを作成するブロック アルゴリズムです。TransformBlock メソッドは、24 ビットの入力ブロックを 32 ビットの文字データに変換します。ブロック変換に一致するように、3 バイトの入力境界と 4 バイトの出力境界を維持する必要があります。

使用例

TransformBlock メソッドを呼び出して、blockSize による inputBytes 変換を反復する方法を次のコード例に示します。このコード例は、ToBase64Transform クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Dim inputBlockSize As Integer
 = base64Transform.InputBlockSize

While (inputBytes.Length - inputOffset > inputBlockSize)
    base64Transform.TransformBlock( _
        inputBytes, _
        inputOffset, _
        inputBytes.Length - inputOffset, _
        outputBytes, _
        0)

    inputOffset += base64Transform.InputBlockSize
    outputFileStream.Write(outputBytes, _
        0, _
        base64Transform.OutputBlockSize)
End While

C#

int inputBlockSize = base64Transform.InputBlockSize;

while(inputBytes.Length - inputOffset > inputBlockSize)
{
    base64Transform.TransformBlock(
        inputBytes,
        inputOffset,
        inputBytes.Length - inputOffset,
        outputBytes,
        0);

    inputOffset += base64Transform.InputBlockSize;
    outputFileStream.Write(
        outputBytes, 
        0, 
        base64Transform.OutputBlockSize);
}

C++

int inputBlockSize = base64Transform->InputBlockSize;
while ( inputBytes->Length - inputOffset > inputBlockSize
 )
{
   base64Transform->TransformBlock(
      inputBytes,
      inputOffset,
      inputBytes->Length - inputOffset,
      outputBytes,
      0 );

   inputOffset += base64Transform->InputBlockSize;
   outputFileStream->Write(
      outputBytes,
      0,
      base64Transform->OutputBlockSize );
}

J#

int inputBlockSize = base64Transform.get_InputBlockSize();
while (inputBytes.get_Length() - inputOffset > inputBlockSize)
 {
    base64Transform.TransformBlock(inputBytes, inputOffset, 
        inputBytes.get_Length() - inputOffset, outputBytes, 0);
    inputOffset += base64Transform.get_InputBlockSize();
    outputFileStream.Write(outputBytes, 0, base64Transform.
        get_OutputBlockSize());
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ToBase64Transform クラス
ToBase64Transform メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス