Sdílet prostřednictvím


CngKey.GetProperty(String, CngPropertyOptions) Metoda

Definice

Získá vlastnost, která má název a sadu možností vlastnosti.

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

Parametry

name
String

Název požadované vlastnosti.

options
CngPropertyOptions

Bitové kombinace hodnot výčtu, které určují možnosti pro pojmenovanou vlastnost.

Návraty

Objekt, který obsahuje nezpracovanou hodnotu zadané vlastnosti.

Atributy

Výjimky

name je null.

Všechny ostatní chyby.

Poznámky

Účelem této metody je vrátit hodnotu libovolné vlastnosti klíče. Typickým způsobem, jak načíst vlastnosti, je použití přístupových objektů vlastností poskytovaných CngKey třídou . CngKey poskytuje obálky pro několik vlastností, ale ne pro všechny. Metoda se GetProperty primárně používá pro přístup k hodnotě vlastnosti, která není zabalena.

Tato metoda je užitečná v následujících případech:

  • Nová verze operačního systému podporuje novou vlastnost klíče CNG (Cryptography Next Generation), která nemá obálku.

  • Ke klíči přidáte vlastní vlastnost.

Parametr options se používá konkrétně k označení následujícího:

  • Určuje, jestli je vlastnost předdefinovaná nebo vlastní.

  • Určuje, zda má být vlastnost trvale zachována s klíčem.

Tyto možnosti musí odpovídat hodnotě, se kterou byla vlastnost nastavena, jinak se vlastnost nenajde.

CryptographicException vyvolá se, pokud se vlastnost nenašla. Nejprve volejte metodu HasProperty , abyste se vyhnuli výjimce místo zabalení volání metody do try/catch bloku.

Platí pro