CngKey.GetProperty(String, CngPropertyOptions) Metodo

Definizione

Ottiene una proprietà, dato un nome e un insieme di opzioni della proprietà.

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

Parametri

name
String

Nome della proprietà desiderata.

options
CngPropertyOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni per la proprietà denominata.

Restituisce

Oggetto contenente il valore non elaborato della proprietà specificata.

Attributi

Eccezioni

name è null.

Tutti gli altri errori.

Commenti

Lo scopo di questo metodo è restituire il valore di una proprietà arbitraria della chiave. Il modo tipico per recuperare le proprietà consiste nell'usare le funzioni di accesso alle CngKey proprietà fornite dalla classe . CngKey fornisce wrapper per diverse proprietà, ma non tutte. Il GetProperty metodo viene usato principalmente per accedere al valore di una proprietà che non è sottoposta a wrapping.

Questo metodo è utile nei casi seguenti:

  • Una nuova versione del sistema operativo supporta una nuova proprietà della chiave CNG (Cryptography Next Generation) che non dispone di un wrapper.

  • Si aggiunge una proprietà personalizzata alla chiave.

Il options parametro viene usato specificamente per indicare quanto segue:

  • Indica se la proprietà è predefinita o personalizzata.

  • Indica se la proprietà deve essere mantenuta con la chiave.

Queste opzioni devono corrispondere al valore con cui è stata impostata la proprietà oppure la proprietà non verrà trovata.

CryptographicException viene generata se non è possibile trovare la proprietà . È necessario chiamare prima il HasProperty metodo per evitare l'eccezione anziché eseguire il wrapping della chiamata al metodo in un try/catch blocco.

Si applica a