DSACryptoServiceProvider.PersistKeyInCsp プロパティ

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

DSACryptoServiceProvider.PersistKeyInCsp プロパティ

暗号サービス プロバイダ (CSP) でキーを永続化する必要があるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property PersistKeyInCsp As
 Boolean

Visual Basic (使用法)

Dim instance As DSACryptoServiceProvider
Dim value As Boolean

value = instance.PersistKeyInCsp

instance.PersistKeyInCsp = value

C#

public bool PersistKeyInCsp { get;
 set; }

C++

public:
property bool PersistKeyInCsp {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_PersistKeyInCsp ()

/** @property */
public void set_PersistKeyInCsp (boolean value)

JScript

public function get PersistKeyInCsp
 () : boolean

public function set PersistKeyInCsp
 (value : boolean)

プロパティ値
キーを CSP で永続化する場合は true。それ以外の場合は false。

解説

キーをキー コンテナ内で永続化する場合は、このプロパティを使用します。

使用例

DSACryptoServiceProvider のインスタンスを作成し、キーをキー コンテナ内で永続化してから、そのキーを削除するコード例を次に示します。

Visual Basic

Imports System.Security.Cryptography

Module DSACSPExample

    Sub Main()

        Dim KeyContainerName As String
 = "MyKeyContainer"

        'Create a new key and persist it in 
        'the key container.  
        DSAPersistKeyInCSP(KeyContainerName)

        'Delete the key from the key container.
        DSADeleteKeyInCSP(KeyContainerName)
    End Sub


    Sub DSAPersistKeyInCSP(ByVal ContainerName
 As String)
        Try
            ' Create a new instance of CspParameters.  Pass
            ' 13 to specify a DSA container or 1 to specify
            ' an DSA container.  The default is 1.
            Dim cspParams As New
 CspParameters

            ' Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName

            'Create a new instance of DSACryptoServiceProvider to generate
            'a new key pair.  Pass the CspParameters class to persist
 the 
            'key in the container.  The PersistKeyInCsp property is
 True by 
            'default, allowing the key to be persisted. 
            Dim DSAalg As New
 DSACryptoServiceProvider(cspParams)

            'Indicate that the key was persisted.
            Console.WriteLine("The DSA key was persisted in the
 container, ""{0}"".",
 ContainerName)
        Catch e As CryptographicException
            Console.WriteLine(e.Message)
        End Try
    End Sub


    Sub DSADeleteKeyInCSP(ByVal ContainerName
 As String)
        Try
            ' Create a new instance of CspParameters.  Pass
            ' 13 to specify a DSA container or 1 to specify
            ' an DSA container.  The default is 1.
            Dim cspParams As New
 CspParameters

            ' Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName

            'Create a new instance of DSACryptoServiceProvider. 
            'Pass the CspParameters class to use the 
            'key in the container.
            Dim DSAalg As New
 DSACryptoServiceProvider(cspParams)

            'Explicitly set the PersistKeyInCsp property to False
            'to delete the key entry in the container.
            DSAalg.PersistKeyInCsp = False

            'Call Clear to release resources and delete the key from
 the container.
            DSAalg.Clear()

            'Indicate that the key was persisted.
            Console.WriteLine("The DSA key was deleted from the
 container, ""{0}"".",
 ContainerName)
        Catch e As CryptographicException
            Console.WriteLine(e.Message)
        End Try
    End Sub

End Module

C#

using System;
using System.Security.Cryptography;

class DSACSPSample
{

    static void Main()
    {

        string KeyContainerName = "MyKeyContainer";

        //Create a new key and persist it in 
        //the key container.  
        DSAPersistKeyInCSP(KeyContainerName);

        //Delete the key from the key container.
        DSADeleteKeyInCSP(KeyContainerName);
    }

    public static void DSAPersistKeyInCSP(string
 ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an DSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of DSACryptoServiceProvider to generate
            //a new key pair.  Pass the CspParameters class to persist
 the 
            //key in the container.  The PersistKeyInCsp property is
 true by 
            //default, allowing the key to be persisted. 
            DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(cspParams);

          

            //Indicate that the key was persisted.
            Console.WriteLine("The DSA key was persisted in
 the container, \"{0}\".", ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

        }
    }

    public static void DSADeleteKeyInCSP(string
 ContainerName)
    {
        try
        {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an DSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();

            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = ContainerName;

            //Create a new instance of DSACryptoServiceProvider. 
            //Pass the CspParameters class to use the 
            //key in the container.
            DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(cspParams);

            //Explicitly set the PersistKeyInCsp property to false
            //to delete the key entry in the container.
            DSAalg.PersistKeyInCsp = false;

            //Call Clear to release resources and delete the key from
 the container.
            DSAalg.Clear();

            //Indicate that the key was persisted.
            Console.WriteLine("The DSA key was deleted from the container, \"{0}\".",
 ContainerName);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

        }
    }
}

C++

using namespace System;
using namespace System::Security::Cryptography;
void DSAPersistKeyInCSP( String^ ContainerName )
{
   try
   {
      
      // Create a new instance of CspParameters.  Pass
      // 13 to specify a DSA container or 1 to specify
      // an DSA container.  The default is 1.
      CspParameters^ cspParams = gcnew CspParameters;
      
      // Specify the container name using the passed variable.
      cspParams->KeyContainerName = ContainerName;
      
      //Create a new instance of DSACryptoServiceProvider to generate
      //a new key pair.  Pass the CspParameters class to persist the
 
      //key in the container.  The PersistKeyInCsp property is true
 by 
      //default, allowing the key to be persisted. 
      DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( cspParams
 );
      
      //Indicate that the key was persisted.
      Console::WriteLine( "The DSA key was persisted in the
 container, \"{0}\".", ContainerName );
   }
   catch ( CryptographicException^ e ) 
   {
      Console::WriteLine( e->Message );
   }

}

void DSADeleteKeyInCSP( String^ ContainerName )
{
   try
   {
      
      // Create a new instance of CspParameters.  Pass
      // 13 to specify a DSA container or 1 to specify
      // an DSA container.  The default is 1.
      CspParameters^ cspParams = gcnew CspParameters;
      
      // Specify the container name using the passed variable.
      cspParams->KeyContainerName = ContainerName;
      
      //Create a new instance of DSACryptoServiceProvider. 
      //Pass the CspParameters class to use the 
      //key in the container.
      DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( cspParams
 );
      
      //Explicitly set the PersistKeyInCsp property to false
      //to delete the key entry in the container.
      DSAalg->PersistKeyInCsp = false;
      
      //Call Clear to release resources and delete the key from the
 container.
      DSAalg->Clear();
      
      //Indicate that the key was persisted.
      Console::WriteLine( "The DSA key was deleted from the container, \"{0}\".",
 ContainerName );
   }
   catch ( CryptographicException^ e ) 
   {
      Console::WriteLine( e->Message );
   }

}

int main()
{
   String^ KeyContainerName = "MyKeyContainer";
   
   //Create a new key and persist it in 
   //the key container.  
   DSAPersistKeyInCSP( KeyContainerName );
   
   //Delete the key from the key container.
   DSADeleteKeyInCSP( KeyContainerName );
}

J#

import System.*;
import System.Security.Cryptography.*;

class DSACSPSample
{
    public static void main(String
 args[])
    {
        String keyContainerName = "MyKeyContainer";
        //Create a new key and persist it in 
        //the key container.  
        DSAPersistKeyInCSP(keyContainerName);
        //Delete the key from the key container.
        DSADeleteKeyInCSP(keyContainerName);
    } //main

    public static void DSAPersistKeyInCSP(String
 containerName)
    {
        try {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an DSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();
            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = containerName;
            //Create a new instance of DSACryptoServiceProvider to generate
            //a new key pair.  Pass the CspParameters class to persist
 the 
            //key in the container.  The PersistKeyInCsp property is
 true by 
            //default, allowing the key to be persisted. 
            DSACryptoServiceProvider dsaAlg = 
                new DSACryptoServiceProvider(cspParams);
            //Indicate that the key was persisted.
            Console.WriteLine("The DSA key was persisted in
 the container, " 
                + "\"{0}\".", containerName);
        }
        catch (CryptographicException e) {
            Console.WriteLine(e.get_Message());
        }
    } //DSAPersistKeyInCSP

    public static void DSADeleteKeyInCSP(String
 containerName)
    {
        try {
            // Create a new instance of CspParameters.  Pass
            // 13 to specify a DSA container or 1 to specify
            // an DSA container.  The default is 1.
            CspParameters cspParams = new CspParameters();
            // Specify the container name using the passed variable.
            cspParams.KeyContainerName = containerName;
            //Create a new instance of DSACryptoServiceProvider. 
            //Pass the CspParameters class to use the 
            //key in the container.
            DSACryptoServiceProvider dsaAlg = 
                new DSACryptoServiceProvider(cspParams);
            //Explicitly set the PersistKeyInCsp property to false
            //to delete the key entry in the container.
            dsaAlg.set_PersistKeyInCsp(false);
            //Call Clear to release resources and delete the key from
 the 
            //container.
            dsaAlg.Clear();
            //Indicate that the key was persisted.
            Console.WriteLine("The DSA key was deleted from the container, "
 
                + "\"{0}\".", containerName);
        }
        catch (CryptographicException e) {
            Console.WriteLine(e.get_Message());
        }
    } //DSADeleteKeyInCSP
} //DSACSPSample

.NET Framework のセキュリティ

• KeyContainerPermission  (キーを削除するために必要なアクセス許可)。Delete (関連する列挙体)。 Demand (セキュリティ アクション)。 または (キーを作成するために必要なアクセス許可)。Create (関連する列挙体)。 Demand (セキュリティ アクション)。

プラットフォーム

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

参照

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