共用方式為

CngKey.GetProperty(String, CngPropertyOptions) 方法

  • 參考

定義

命名空間:
System.Security.Cryptography
組件:
System.Security.Cryptography.Cng.dll
組件:
System.Security.Cryptography.dll
組件:
System.Core.dll
組件:
netstandard.dll, System.Security.Cryptography.Cng.dll
套件:
System.Security.Cryptography.Cng v5.0.0
來源:
Cng.NotSupported.cs
來源:
Cng.NotSupported.cs
來源:
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);
[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

參數

name
String

所需屬性的名稱。

options
CngPropertyOptions

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

傳回

CngProperty

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

屬性
SecurityCriticalAttribute

例外狀況

ArgumentNullException

name 為 null。

CryptographicException

所有其他錯誤。

備註

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

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

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

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

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

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

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

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

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

適用於