CngKey.GetProperty(String, CngPropertyOptions) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.CngPropertyPublic Function GetProperty (name As String, options As CngPropertyOptions) As CngPropertyParamè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.
