CngKey.GetProperty(String, CngPropertyOptions) Metoda

Definice

Obor názvů:
System.Security.Cryptography
Sestavení:
System.Security.Cryptography.dll
Sestavení:
System.Security.Cryptography.Cng.dll
Sestavení:
System.Security.Cryptography.dll, System.Security.Cryptography.Cng.dll
Sestavení:
System.Core.dll
Zdroj:
Cng.NotSupported.cs
Zdroj:
Cng.NotSupported.cs
Zdroj:
Cng.NotSupported.cs
Zdroj:
Cng.NotSupported.cs
Zdroj:
Cng.NotSupported.cs

Získá vlastnost, s ohledem na 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 pojmenované vlastnosti.

Návraty

CngProperty

Objekt, který obsahuje nezpracovanou hodnotu zadané vlastnosti.

Atributy
SecurityCriticalAttribute

Výjimky

ArgumentNullException

name je null.

CryptographicException

Všechny ostatní chyby.

Poznámky

Účelem této metody je vrátit hodnotu libovolné vlastnosti klíče. Typický způsob, jak načíst vlastnosti, je použití přístupových objektů vlastností poskytovaných CngKey třídou. CngKey poskytuje obálky pro několik, ale ne všechny vlastnosti. Metoda GetProperty se 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.

  • Do klíče přidáte vlastní vlastnost.

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

  • Určuje, jestli je vlastnost integrovaná, nebo vlastní.

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

Tyto možnosti musí odpovídat hodnotě, se kterou byla vlastnost nastavena, nebo vlastnost nebyla nalezena.

CryptographicException je vyvolán, pokud vlastnost nebyla nalezena. Nejprve byste měli volat metodu HasProperty , abyste se vyhnuli výjimce namísto zabalení volání metody do try/catch bloku.

Platí pro