Compartilhar via


CngKey.GetProperty(String, CngPropertyOptions) Método

Definição

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.CngProperty
Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

Parâ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.

Aplica-se a