CngKey.GetProperty(String, CngPropertyOptions) Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Source:

Cng.NotSupported.cs

Obtient une propriété, étant donné un nom et un jeu d'options de propriété.

public:
 System::Security::Cryptography::CngProperty GetProperty(System::String ^ name, System::Security::Cryptography::CngPropertyOptions options);

public System.Security.Cryptography.CngProperty GetProperty (string name, System.Security.Cryptography.CngPropertyOptions options);

member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty

Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Paramètres

name

String

Nom de la propriété souhaitée.

options

CngPropertyOptions

Combinaison d'opérations de bits des valeurs d'énumération qui spécifient les options pour la propriété nommée.

Retours

CngProperty

Objet qui contient la valeur brute de la propriété spécifiée.

Exceptions

ArgumentNullException

name a la valeur null.

CryptographicException

Toutes les autres erreurs.

Remarques

L’objectif de cette méthode est de retourner la valeur d’une propriété arbitraire de la clé. La méthode classique pour récupérer des propriétés consiste à utiliser les accesseurs de propriété fournis par la CngKey classe . CngKey fournit des wrappers pour plusieurs propriétés, mais pas toutes. La GetProperty méthode est principalement utilisée pour accéder à la valeur d’une propriété qui n’est pas encapsulée.

Cette méthode est utile dans les cas suivants :

• Une nouvelle version du système d’exploitation prend en charge une nouvelle propriété de clé CNG (Cryptography Next Generation) qui n’a pas de wrapper.

• Vous ajoutez une propriété personnalisée à la clé.

Le options paramètre est spécifiquement utilisé pour indiquer les éléments suivants :

• Indique si la propriété est intégrée ou personnalisée.

• Indique si la propriété doit être conservée avec la clé.

Ces options doivent correspondre à la valeur avec laquelle la propriété a été définie, sinon la propriété est introuvable.

CryptographicException est levée si la propriété est introuvable. Vous devez d’abord appeler la HasProperty méthode pour éviter l’exception au lieu d’encapsuler l’appel de méthode dans un try/catch bloc.