Partager via


CngKey.GetProperty(String, CngPropertyOptions) Méthode

Définition

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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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

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

Attributs

Exceptions

name a la valeur null.

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.

S’applique à