Aracılığıyla paylaş


CngKey.GetProperty(String, CngPropertyOptions) Yöntem

Tanım

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.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

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.

Şunlara uygulanır