Freigeben über


CspParameters.KeyNumber-Feld

Gibt an, ob ein asymmetrischer Schlüssel als Signaturschlüssel oder als Austauschschlüssel erstellt wird.

Namespace: System.Security.Cryptography
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public KeyNumber As Integer
'Usage
Dim instance As CspParameters
Dim value As Integer

value = instance.KeyNumber

instance.KeyNumber = value
public int KeyNumber
public:
int KeyNumber
public int KeyNumber
public var KeyNumber : int

Hinweise

Wenn Sie ein CspKeyContainerInfo-Objekt mit einem CspParameters-Objekt initialisieren, wird mit dem KeyNumber-Feld die KeyNumber-Eigenschaft initialisiert.

Ein Austauschschlüssel ist ein asymmetrisches Schlüsselpaar für die Verschlüsselung von Sitzungsschlüsseln, sodass diese sicher gespeichert und mit anderen Benutzern ausgetauscht werden können. Sie können den Exchange-Wert (1) verwenden, um einen Austauschschlüssel anzugeben. Dieser Wert entspricht dem AT_KEYEXCHANGE-Wert, der in der nicht verwalteten Microsoft Cryptographic API (CAPI) verwendet wird.

Ein Signaturschlüssel ist ein asymmetrisches Schlüsselpaar für die Authentifizierung von Nachrichten oder Dateien mit digitaler Signatur. Sie können den Signature-Wert (2) verwenden, um einen Signaturschlüssel anzugeben. Dieser Wert entspricht dem in CAPI verwendeten AT_SIGNATURE-Wert.

Standardmäßig gibt das KeyNumber-Feld einen Austauschschlüssel an.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der KeyNumber-Enumeration veranschaulicht, um einen Schlüsseltyp für ein RSACryptoServiceProvider-Objekt anzugeben.

' Create a new CspParameters object.
Dim cspParams As New CspParameters()

' Specify an exchange key.
cspParams.KeyNumber = Fix(KeyNumber.Exchange)

' Initialize the RSACryptoServiceProvider  
' with the CspParameters object.
Dim RSACSP As New RSACryptoServiceProvider(cspParams)
// Create a new CspParameters object.
CspParameters cspParams = new CspParameters();

// Specify an exchange key.
cspParams.KeyNumber = (int) KeyNumber.Exchange;

// Initialize the RSACryptoServiceProvider  
// with the CspParameters object.
RSACryptoServiceProvider RSACSP = new RSACryptoServiceProvider(cspParams);
// Create a new CspParameters object.
CspParameters^ cspParams = gcnew CspParameters();

// Specify an exchange key.
cspParams->KeyNumber = (int) KeyNumber::Exchange;

// Initialize the RSACryptoServiceProvider
// with the CspParameters object.
RSACryptoServiceProvider^ RSACSP = gcnew RSACryptoServiceProvider(cspParams);

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

CspParameters-Klasse
CspParameters-Member
System.Security.Cryptography-Namespace

Weitere Ressourcen

Kryptografische Dienste