다음을 통해 공유


CngKey.GetProperty(String, CngPropertyOptions) 메서드

정의

이름 및 속성 옵션 집합을 사용하여 속성을 가져옵니다.

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

명명된 속성에 대한 옵션을 지정하는 열거형 값의 비트 조합입니다.

반환

지정된 속성의 원시 값이 들어 있는 개체입니다.

특성

예외

name이(가) null인 경우

다른 모든 오류입니다.

설명

이 메서드의 목적은 키의 임의 속성 값을 반환하는 것입니다. 속성을 검색하는 일반적인 방법은 클래스에서 제공하는 속성 접근자를 사용하는 것입니다 CngKey . CngKey 는 여러 속성에 대한 래퍼를 제공하지만 전부는 아닙니다. 메서드는 GetProperty 래핑되지 않은 속성의 값에 액세스하는 데 주로 사용됩니다.

이 메서드는 다음과 같은 경우에 유용합니다.

  • 새 버전의 운영 체제는 래퍼가 없는 새 CNG(Cryptography Next Generation) 키 속성을 지원합니다.

  • 키에 사용자 지정 속성을 추가합니다.

options 매개 변수는 특히 다음을 나타내는 데 사용됩니다.

  • 속성이 기본 제공인지 사용자 지정인지 여부입니다.

  • 속성을 키와 함께 유지할지 여부입니다.

이러한 옵션은 속성이 설정된 값과 일치해야 합니다. 그렇지 않으면 속성을 찾을 수 없습니다.

CryptographicException 속성을 찾을 수 없는 경우 throw됩니다. 메서드 호출을 블록에 HasProperty 래핑하는 대신 예외를 방지하려면 먼저 메서드를 try/catch 호출해야 합니다.

적용 대상