TripleDES クラス

定義

すべての TripleDES 実装の派生元となる Triple DES (Data Encryption Standard) アルゴリズムの基底クラスを表します。Represents the base class for Triple Data Encryption Standard algorithms from which all TripleDES implementations must derive.

public ref class TripleDES abstract : System::Security::Cryptography::SymmetricAlgorithm
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TripleDES : System.Security.Cryptography.SymmetricAlgorithm
type TripleDES = class
    inherit SymmetricAlgorithm
Public MustInherit Class TripleDES
Inherits SymmetricAlgorithm
継承
派生
属性

次のコード例では、指定されたキー (Key) と初期化ベクター (IV) を使用して TripleDESCryptoServiceProvider を使用して、inNameで指定されたファイルを暗号化します。The following code example method uses TripleDESCryptoServiceProvider with the specified key (Key) and initialization vector (IV) to encrypt a file specified by inName. 次に、暗号化された結果を outNameによって指定されたファイルに出力します。It then outputs the encrypted result to the file specified by outName.

void EncryptData( String^ inName, String^ outName, array<Byte>^tdesKey, array<Byte>^tdesIV )
{
   
   //Create the file streams to handle the input and output files.
   FileStream^ fin = gcnew FileStream( inName,FileMode::Open,FileAccess::Read );
   FileStream^ fout = gcnew FileStream( outName,FileMode::OpenOrCreate,FileAccess::Write );
   fout->SetLength( 0 );
   
   //Create variables to help with read and write.
   array<Byte>^bin = gcnew array<Byte>(100);
   long rdlen = 0; //This is the total number of bytes written.

   long totlen = (long)fin->Length; //This is the total length of the input file.

   int len; //This is the number of bytes to be written at a time.

   TripleDESCryptoServiceProvider^ tdes = gcnew TripleDESCryptoServiceProvider;
   CryptoStream^ encStream = gcnew CryptoStream( fout,tdes->CreateEncryptor( tdesKey, tdesIV ),CryptoStreamMode::Write );
   Console::WriteLine( "Encrypting..." );
   
   //Read from the input file, then encrypt and write to the output file.
   while ( rdlen < totlen )
   {
      len = fin->Read( bin, 0, 100 );
      encStream->Write( bin, 0, len );
      rdlen = rdlen + len;
      Console::WriteLine( "{0} bytes processed", rdlen );
   }

   encStream->Close();
}

private static void EncryptData(String inName, String outName, byte[] tdesKey, byte[] tdesIV)
{    
    //Create the file streams to handle the input and output files.
    FileStream fin = new FileStream(inName, FileMode.Open, FileAccess.Read);
    FileStream fout = new FileStream(outName, FileMode.OpenOrCreate, FileAccess.Write);
    fout.SetLength(0);
      
    //Create variables to help with read and write.
    byte[] bin = new byte[100]; //This is intermediate storage for the encryption.
    long rdlen = 0;              //This is the total number of bytes written.
    long totlen = fin.Length;    //This is the total length of the input file.
    int len;                     //This is the number of bytes to be written at a time.

    TripleDESCryptoServiceProvider tdes = new TripleDESCryptoServiceProvider();          
    CryptoStream encStream = new CryptoStream(fout, tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write);
               
    Console.WriteLine("Encrypting...");

    //Read from the input file, then encrypt and write to the output file.
    while(rdlen < totlen)
    {
        len = fin.Read(bin, 0, 100);
        encStream.Write(bin, 0, len);
        rdlen = rdlen + len;
        Console.WriteLine("{0} bytes processed", rdlen);
    }

    encStream.Close();                     
}
Private Shared Sub EncryptData(inName As String, outName As String, _
   tdesKey() As Byte, tdesIV() As Byte)
   
    'Create the file streams to handle the input and output files.
    Dim fin As New FileStream(inName, FileMode.Open, FileAccess.Read)
    Dim fout As New FileStream(outName, FileMode.OpenOrCreate, _
       FileAccess.Write)
    fout.SetLength(0)
        
    'Create variables to help with read and write.
    Dim bin(100) As Byte 'This is intermediate storage for the encryption.
    Dim rdlen As Long = 0 'This is the total number of bytes written.
    Dim totlen As Long = fin.Length 'This is the total length of the input file.
    Dim len As Integer 'This is the number of bytes to be written at a time.
    Dim tdes As New TripleDESCryptoServiceProvider()
    Dim encStream As New CryptoStream(fout, _
       tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write)
        
    Console.WriteLine("Encrypting...")
        
    'Read from the input file, then encrypt and write to the output file.
    While rdlen < totlen
        len = fin.Read(bin, 0, 100)
        encStream.Write(bin, 0, len)
        rdlen = rdlen + len
        Console.WriteLine("{0} bytes processed", rdlen)
    End While
        
    encStream.Close()
End Sub

復号化は同じ方法で処理できます。CreateEncryptorではなく CreateDecryptor を使用します。Decryption can be handled in the same way; use CreateDecryptor instead of CreateEncryptor. ファイルの暗号化に使用するのと同じキー (Key) と初期化ベクター (IV) を使用して暗号化を解除する必要があります。The same key (Key) and initialization vector (IV) used to encrypt the file must be used to decrypt it.

注釈

TripleDES は、DES アルゴリズムを3回連続して使用します。TripleDES uses three successive iterations of the DES algorithm. 2つまたは 3 56 ビットのキーを使用できます。It can use either two or three 56-bit keys.

注意

新しい対称暗号化アルゴリズム (Advanced Encryption Standard (AES)) を使用できます。A newer symmetric encryption algorithm, Advanced Encryption Standard (AES), is available. TripleDES クラスではなく、Aes クラスとその派生クラスを使用することを検討してください。Consider using the Aes class and its derived classes instead of the TripleDES class. TripleDES は、レガシアプリケーションおよびデータとの互換性のためだけに使用してください。Use TripleDES only for compatibility with legacy applications and data.

このアルゴリズムは、128ビットから192ビットまでのキーの長さを64ビット単位でサポートします。This algorithm supports key lengths from 128 bits to 192 bits in increments of 64 bits.

コンストラクター

TripleDES()

TripleDES クラスの新しいインスタンスを初期化します。Initializes a new instance of the TripleDES class.

フィールド

BlockSizeValue

暗号操作のブロック サイズをビット単位で表します。Represents the block size, in bits, of the cryptographic operation.

(継承元 SymmetricAlgorithm)
FeedbackSizeValue

暗号操作のフィードバック サイズをビット単位で表します。Represents the feedback size, in bits, of the cryptographic operation.

(継承元 SymmetricAlgorithm)
IVValue

対称アルゴリズムで使用する初期化ベクター (IV) を表します。Represents the initialization vector (IV) for the symmetric algorithm.

(継承元 SymmetricAlgorithm)
KeySizeValue

対称アルゴリズムで使用する共有キーのサイズをビット単位で表します。Represents the size, in bits, of the secret key used by the symmetric algorithm.

(継承元 SymmetricAlgorithm)
KeyValue

対称アルゴリズムの共有キーを表します。Represents the secret key for the symmetric algorithm.

(継承元 SymmetricAlgorithm)
LegalBlockSizesValue

対称アルゴリズムでサポートされているブロック サイズをビット単位で指定します。Specifies the block sizes, in bits, that are supported by the symmetric algorithm.

(継承元 SymmetricAlgorithm)
LegalKeySizesValue

対称アルゴリズムでサポートされているキー サイズをビット単位で指定します。Specifies the key sizes, in bits, that are supported by the symmetric algorithm.

(継承元 SymmetricAlgorithm)
ModeValue

対称アルゴリズムで使用する暗号モードを表します。Represents the cipher mode used in the symmetric algorithm.

(継承元 SymmetricAlgorithm)
PaddingValue

対称アルゴリズムで使用する埋め込みモードを表します。Represents the padding mode used in the symmetric algorithm.

(継承元 SymmetricAlgorithm)

プロパティ

BlockSize

暗号操作のブロック サイズをビット単位で取得または設定します。Gets or sets the block size, in bits, of the cryptographic operation.

(継承元 SymmetricAlgorithm)
FeedbackSize

暗号フィードバック (CFB) および出力フィードバック (OFB) の暗号モードにおける暗号化操作のフィードバック サイズをビット単位で取得または設定します。Gets or sets the feedback size, in bits, of the cryptographic operation for the Cipher Feedback (CFB) and Output Feedback (OFB) cipher modes.

(継承元 SymmetricAlgorithm)
IV

対称アルゴリズムの初期化ベクター (IV) を取得または設定します。Gets or sets the initialization vector (IV) for the symmetric algorithm.

(継承元 SymmetricAlgorithm)
Key

TripleDES アルゴリズムの共有キーを取得または設定します。Gets or sets the secret key for the TripleDES algorithm.

KeySize

対称アルゴリズムで使用する共有キーのサイズをビット単位で取得または設定します。Gets or sets the size, in bits, of the secret key used by the symmetric algorithm.

(継承元 SymmetricAlgorithm)
LegalBlockSizes

対称アルゴリズムでサポートされているブロック サイズをビット単位で取得します。Gets the block sizes, in bits, that are supported by the symmetric algorithm.

LegalKeySizes

対称アルゴリズムでサポートされているキー サイズをビット単位で取得します。Gets the key sizes, in bits, that are supported by the symmetric algorithm.

Mode

対称アルゴリズムの操作モードを取得または設定します。Gets or sets the mode for operation of the symmetric algorithm.

(継承元 SymmetricAlgorithm)
Padding

対称アルゴリズムで使用する埋め込みモードを取得または設定します。Gets or sets the padding mode used in the symmetric algorithm.

(継承元 SymmetricAlgorithm)

メソッド

Clear()

SymmetricAlgorithm クラスによって使用されているすべてのリソースを解放します。Releases all resources used by the SymmetricAlgorithm class.

(継承元 SymmetricAlgorithm)
Create()

TripleDES アルゴリズムを実行するための暗号オブジェクトのインスタンスを作成します。Creates an instance of a cryptographic object to perform the TripleDES algorithm.

Create(String)

TripleDES アルゴリズムの指定した実装を実行する暗号オブジェクトのインスタンスを作成します。Creates an instance of a cryptographic object to perform the specified implementation of the TripleDES algorithm.

CreateDecryptor()

現在の Key プロパティおよび初期化ベクター (IV) を使用して、対称復号化オブジェクトを作成します。Creates a symmetric decryptor object with the current Key property and initialization vector (IV).

(継承元 SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])

派生クラスでオーバーライドされると、指定した Key プロパティおよび初期化ベクター (IV) を使用して、対称復号化オブジェクトを作成します。When overridden in a derived class, creates a symmetric decryptor object with the specified Key property and initialization vector (IV).

(継承元 SymmetricAlgorithm)
CreateEncryptor()

現在の Key プロパティおよび初期化ベクター (IV) を使用して、対称暗号化オブジェクトを作成します。Creates a symmetric encryptor object with the current Key property and initialization vector (IV).

(継承元 SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])

派生クラスでオーバーライドされると、指定した Key プロパティおよび初期化ベクター (IV) を使用して、対称暗号化オブジェクトを作成します。When overridden in a derived class, creates a symmetric encryptor object with the specified Key property and initialization vector (IV).

(継承元 SymmetricAlgorithm)
Dispose()

SymmetricAlgorithm クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。Releases all resources used by the current instance of the SymmetricAlgorithm class.

(継承元 SymmetricAlgorithm)
Dispose(Boolean)

SymmetricAlgorithm によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the SymmetricAlgorithm and optionally releases the managed resources.

(継承元 SymmetricAlgorithm)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GenerateIV()

派生クラスでオーバーライドされると、アルゴリズムで使用するランダムな初期化ベクター (IV) を生成します。When overridden in a derived class, generates a random initialization vector (IV) to use for the algorithm.

(継承元 SymmetricAlgorithm)
GenerateKey()

派生クラスでオーバーライドされると、アルゴリズムで使用するランダム キー (Key) を生成します。When overridden in a derived class, generates a random key (Key) to use for the algorithm.

(継承元 SymmetricAlgorithm)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IsWeakKey(Byte[])

指定したキーが脆弱かどうかを確認します。Determines whether the specified key is weak.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)
ValidKeySize(Int32)

指定されたキー サイズが、現在のアルゴリズムに対して有効かどうかを判断します。Determines whether the specified key size is valid for the current algorithm.

(継承元 SymmetricAlgorithm)

明示的なインターフェイスの実装

IDisposable.Dispose()

SymmetricAlgorithm によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the SymmetricAlgorithm and optionally releases the managed resources.

(継承元 SymmetricAlgorithm)

適用対象

こちらもご覧ください