CngKey.GetProperty(String, CngPropertyOptions) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.CngPropertyPublic Function GetProperty (name As String, options As CngPropertyOptions) As CngPropertyParametry
- 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.
