CngKey.GetProperty(String, CngPropertyOptions) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma propriedade, dado um nome e um conjunto de opções da propriedade.
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 CngPropertyParâmetros
- name
- String
O nome da propriedade desejada.
- options
- CngPropertyOptions
Uma combinação bit a bit dos valores de enumeração que especifica opções para a propriedade nomeada.
Retornos
Um objeto que contém o valor bruto da propriedade especificada.
- Atributos
Exceções
name é null.
Todos os outros erros.
Comentários
A finalidade desse método é retornar o valor de uma propriedade arbitrária da chave. A maneira típica de recuperar propriedades é usando os acessadores de propriedade fornecidos pela CngKey classe . CngKey fornece wrappers para várias propriedades, mas não todas. O GetProperty método é usado principalmente para acessar o valor de uma propriedade que não está encapsulada.
Esse método é útil nos seguintes casos:
Uma nova versão do sistema operacional dá suporte a uma nova propriedade de chave CNG (Cryptography Next Generation) que não tem um wrapper.
Você adiciona uma propriedade personalizada à chave.
O options parâmetro é usado especificamente para indicar o seguinte:
Se a propriedade é interna ou personalizada.
Se a propriedade deve ser mantida com a chave.
Essas opções devem corresponder ao valor com o qual a propriedade foi definida ou a propriedade não será encontrada.
CryptographicException será gerado se a propriedade não puder ser encontrada. Você deve chamar o HasProperty método primeiro para evitar a exceção em vez de encapsular a chamada de método em um try/catch bloco.
