CngKey.GetProperty(String, CngPropertyOptions) 方法

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

來源:

Cng.NotSupported.cs

取得屬性，收到指定名稱和一組屬性選項。

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);

member this.GetProperty : string * System.Security.Cryptography.CngPropertyOptions -> System.Security.Cryptography.CngProperty

Public Function GetProperty (name As String, options As CngPropertyOptions) As CngProperty

參數

name

String

所需屬性的名稱。

options

CngPropertyOptions

列舉型別值的位元組合，指定具名屬性的選項。

傳回

CngProperty

物件，包含指定屬性未經處理的值。

例外狀況

ArgumentNullException

name 為 null。

CryptographicException

所有其他錯誤。

備註

這個方法的目的是要傳回索引鍵任意屬性的值。 擷取屬性的一般方式是使用 類別所提供的 CngKey 屬性存取子。 CngKey 提供數個但並非所有屬性的包裝函式。 方法 GetProperty 主要用於存取未包裝之屬性的值。

此方法在下列情況下很有用：

• 新版本的操作系統支援新的密碼編譯新一代 (CNG) 沒有包裝函式的密鑰屬性。

• 您會將自訂屬性新增至索引鍵。

參數 options 特別用來指出下列各項：

• 屬性是內建還是自定義。

• 屬性是否應該與索引鍵一起保存。

這些選項必須符合已設定屬性的值，否則找不到屬性。

CryptographicException 如果找不到屬性，則會擲回 。 您應該先呼叫 HasProperty 方法，以避免例外狀況，而不是將方法呼叫包裝在 區塊中 try/catch 。