CngKey.GetProperty(String, CngPropertyOptions) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在给定名称和一组属性选项的情况下，获取一个属性。
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 CngProperty参数
- name
- String
所需属性的名称。
- options
- CngPropertyOptions
指定已命名属性选项的枚举值的按位组合。
返回
一个包含指定属性的原始值的对象。
- 属性
例外
name 为 null。
所有其他错误。
注解
此方法的目的是返回键的任意属性的值。 检索属性的典型方法是使用 类提供 CngKey 的属性访问器。 CngKey 为多个（但不是所有）属性提供包装器。 方法 GetProperty 主要用于访问未包装的属性的值。
此方法在以下情况下很有用：
新版本的操作系统支持没有包装器的新加密下一代 (CNG) 密钥属性。
向键添加自定义属性。
参数 options 专门用于指示以下内容：
属性是内置属性还是自定义属性。
属性是否应与 键一起保留。
这些选项必须与设置属性时使用的值匹配，否则将找不到该属性。
CryptographicException 如果找不到属性，则引发 。 应首先调用 HasProperty 方法以避免异常，而不是将方法调用包装在 块中 try/catch 。
