CngKey.GetProperty(String, CngPropertyOptions) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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);[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 CngPropertyParametreler
- 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
Belirtilen özelliğin ham değerini içeren bir nesne.
- Öznitelikler
Özel durumlar
name, null değeridir.
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.
