CngKey.GetProperty(String, CngPropertyOptions) Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

Cng.NotSupported.cs

Bir ad ve özellik seçenekleri kümesi verilen bir özelliği alır.

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

Parametreler

name

String

İstenen özelliğin adı.

options

CngPropertyOptions

Adlandırılmış özellik için seçenekleri belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

Döndürülenler

CngProperty

Belirtilen özelliğin ham değerini içeren bir nesne.

Özel durumlar

ArgumentNullException

name, null değeridir.

CryptographicException

Diğer tüm hatalar.

Açıklamalar

Bu yöntemin amacı, anahtarın rastgele bir özelliğinin değerini döndürmektir. Özellikleri almanın tipik yolu, sınıfı tarafından CngKey sağlanan özellik erişimcilerini kullanmaktır. CngKey çeşitli özellikler için sarmalayıcılar sağlar, ancak tümü için değil. GetProperty yöntemi öncelikle sarmalı olmayan bir özelliğin değerine erişmek için kullanılır.

Bu yöntem aşağıdaki durumlarda yararlıdır:

• İşletim sisteminin yeni bir sürümü, sarmalayıcı içermeyen yeni bir Şifreleme Yeni Nesil (CNG) anahtar özelliğini destekler.

• Anahtara özel bir özellik eklersiniz.

options parametresi özellikle aşağıdakileri belirtmek için kullanılır:

• Özelliğin yerleşik mi yoksa özel mi olduğu.

• Özelliğin anahtarıyla kalıcı olup olmaması.

Bu seçenekler özelliğin ayarlandığı değerle eşleşmelidir, aksi takdirde özellik bulunamaz.

CryptographicException özelliği bulunamazsa oluşturulur. Yöntem çağrısını bir try/catch blokta HasProperty sarmalamaktansa özel durumdan kaçınmak için önce yöntemini çağırmalısınız.