CspKeyContainerInfo.KeyNumber Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá hodnotu, která popisuje, zda asymetrický klíč byl vytvořen jako podpis klíč nebo klíč výměny.
public:
property System::Security::Cryptography::KeyNumber KeyNumber { System::Security::Cryptography::KeyNumber get(); };
public System.Security.Cryptography.KeyNumber KeyNumber { get; }
member this.KeyNumber : System.Security.Cryptography.KeyNumber
Public ReadOnly Property KeyNumber As KeyNumber
Hodnota vlastnosti
Jedna z KeyNumber hodnot, která popisuje, jestli byl asymetrický klíč vytvořen jako podpisový nebo výměnný klíč.
Příklady
Následující příklad kódu vytvoří kontejner klíčů a načte informace o tomto kontejneru.
using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Text;
int main()
{
RSACryptoServiceProvider^ rsa = gcnew RSACryptoServiceProvider;
try
{
// Note: In cases where a random key is generated,
// a key container is not created until you call
// a method that uses the key. This example calls
// the Encrypt method before calling the
// CspKeyContainerInfo property so that a key
// container is created.
// Create some data to encrypt and display it.
String^ data = L"Here is some data to encrypt.";
Console::WriteLine( L"Data to encrypt: {0}", data );
// Convert the data to an array of bytes and
// encrypt it.
array<Byte>^byteData = Encoding::ASCII->GetBytes( data );
array<Byte>^encData = rsa->Encrypt( byteData, false );
// Display the encrypted value.
Console::WriteLine( L"Encrypted Data: {0}", Encoding::ASCII->GetString( encData ) );
Console::WriteLine();
Console::WriteLine( L"CspKeyContainerInfo information:" );
Console::WriteLine();
// Create a new CspKeyContainerInfo object.
CspKeyContainerInfo^ keyInfo = rsa->CspKeyContainerInfo;
// Display the value of each property.
Console::WriteLine( L"Accessible property: {0}", keyInfo->Accessible );
Console::WriteLine( L"Exportable property: {0}", keyInfo->Exportable );
Console::WriteLine( L"HardwareDevice property: {0}", keyInfo->HardwareDevice );
Console::WriteLine( L"KeyContainerName property: {0}", keyInfo->KeyContainerName );
Console::WriteLine( L"KeyNumber property: {0}", keyInfo->KeyNumber );
Console::WriteLine( L"MachineKeyStore property: {0}", keyInfo->MachineKeyStore );
Console::WriteLine( L"Protected property: {0}", keyInfo->Protected );
Console::WriteLine( L"ProviderName property: {0}", keyInfo->ProviderName );
Console::WriteLine( L"ProviderType property: {0}", keyInfo->ProviderType );
Console::WriteLine( L"RandomlyGenerated property: {0}", keyInfo->RandomlyGenerated );
Console::WriteLine( L"Removable property: {0}", keyInfo->Removable );
Console::WriteLine( L"UniqueKeyContainerName property: {0}", keyInfo->UniqueKeyContainerName );
}
catch ( Exception^ e )
{
Console::WriteLine( e );
}
finally
{
// Clear the key.
rsa->Clear();
}
}
using System;
using System.Security.Cryptography;
using System.Text;
public class CspKeyContainerInfoExample
{
public static void Main(String[] args)
{
RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();
try
{
// Note: In cases where a random key is generated,
// a key container is not created until you call
// a method that uses the key. This example calls
// the Encrypt method before calling the
// CspKeyContainerInfo property so that a key
// container is created.
// Create some data to encrypt and display it.
string data = "Here is some data to encrypt.";
Console.WriteLine("Data to encrypt: " + data);
// Convert the data to an array of bytes and
// encrypt it.
byte[] byteData = Encoding.ASCII.GetBytes(data);
byte[] encData = rsa.Encrypt(byteData, false);
// Display the encrypted value.
Console.WriteLine("Encrypted Data: " + Encoding.ASCII.GetString(encData));
Console.WriteLine();
Console.WriteLine("CspKeyContainerInfo information:");
Console.WriteLine();
// Create a new CspKeyContainerInfo object.
CspKeyContainerInfo keyInfo = rsa.CspKeyContainerInfo;
// Display the value of each property.
Console.WriteLine("Accessible property: " + keyInfo.Accessible);
Console.WriteLine("Exportable property: " + keyInfo.Exportable);
Console.WriteLine("HardwareDevice property: " + keyInfo.HardwareDevice);
Console.WriteLine("KeyContainerName property: " + keyInfo.KeyContainerName);
Console.WriteLine("KeyNumber property: " + keyInfo.KeyNumber.ToString());
Console.WriteLine("MachineKeyStore property: " + keyInfo.MachineKeyStore);
Console.WriteLine("Protected property: " + keyInfo.Protected);
Console.WriteLine("ProviderName property: " + keyInfo.ProviderName);
Console.WriteLine("ProviderType property: " + keyInfo.ProviderType);
Console.WriteLine("RandomlyGenerated property: " + keyInfo.RandomlyGenerated);
Console.WriteLine("Removable property: " + keyInfo.Removable);
Console.WriteLine("UniqueKeyContainerName property: " + keyInfo.UniqueKeyContainerName);
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
finally
{
// Clear the key.
rsa.Clear();
}
}
}
Imports System.Security.Cryptography
Imports System.Text
Module CspKeyContainerInfoExample
Sub Main(ByVal args() As String)
Dim rsa As New RSACryptoServiceProvider()
Try
' Note: In cases where a random key is generated,
' a key container is not created until you call
' a method that uses the key. This example calls
' the Encrypt method before calling the
' CspKeyContainerInfo property so that a key
' container is created.
' Create some data to encrypt and display it.
Dim data As String = "Here is some data to encrypt."
Console.WriteLine("Data to encrypt: " + data)
' Convert the data to an array of bytes and
' encrypt it.
Dim byteData As Byte() = Encoding.ASCII.GetBytes(data)
Dim encData As Byte() = rsa.Encrypt(byteData, False)
' Display the encrypted value.
Console.WriteLine("Encrypted Data: " + Encoding.ASCII.GetString(encData))
Console.WriteLine()
Console.WriteLine("CspKeyContainerInfo information:")
Console.WriteLine()
' Create a new CspKeyContainerInfo object.
Dim keyInfo As CspKeyContainerInfo = rsa.CspKeyContainerInfo
' Display the value of each property.
Console.WriteLine("Accessible property: " + keyInfo.Accessible.ToString())
Console.WriteLine("Exportable property: " + keyInfo.Exportable.ToString())
Console.WriteLine("HardwareDevice property: " + keyInfo.HardwareDevice.ToString())
Console.WriteLine("KeyContainerName property: " + keyInfo.KeyContainerName)
Console.WriteLine("KeyNumber property: " + keyInfo.KeyNumber.ToString())
Console.WriteLine("MachineKeyStore property: " + keyInfo.MachineKeyStore.ToString())
Console.WriteLine("Protected property: " + keyInfo.Protected.ToString())
Console.WriteLine("ProviderName property: " + keyInfo.ProviderName)
Console.WriteLine("ProviderType property: " + keyInfo.ProviderType.ToString())
Console.WriteLine("RandomlyGenerated property: " + keyInfo.RandomlyGenerated.ToString())
Console.WriteLine("Removable property: " + keyInfo.Removable.ToString())
Console.WriteLine("UniqueKeyContainerName property: " + keyInfo.UniqueKeyContainerName)
Catch e As Exception
Console.WriteLine(e.ToString())
Finally
' Clear the key.
rsa.Clear()
End Try
Console.ReadLine()
End Sub
End Module
Poznámky
Hodnota KeyNumber vlastnosti je odvozena z KeyNumber pole objektu CspParameters , který byl použit k inicializaci objektu CspKeyContainerInfo .
Výměnný klíč je asymetrický pár klíčů, který slouží k šifrování klíčů relace, aby je bylo možné bezpečně ukládat a vyměňovat s ostatními uživateli. Hodnota Exchange určuje klíč výměny. Tato hodnota odpovídá hodnotě AT_KEYEXCHANGE
použité v nespravovaném rozhraní MICROSOFT Cryptographic API (CAPI).
Klíč podpisu je asymetrický pár klíčů, který se používá k ověřování (digitálně podepsaných) zpráv nebo souborů. Hodnota Signature určuje klíč podpisu. Tato hodnota odpovídá hodnotě AT_SIGNATURE
použité v capi.