CngKey.GetProperty(String, CngPropertyOptions) 方法

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

Source:

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 。