CngKey.GetProperty(String, CngPropertyOptions) Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.Cng.dll

Assembly:

System.Security.Cryptography.dll

Assembly:

System.Core.dll

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

CngProperty

Um objeto que contém o valor bruto da propriedade especificada.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentNullException

name é null.

CryptographicException

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á gerada 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.