CngKey.GetProperty(String, CngPropertyOptions) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar en egenskap med ett namn och en uppsättning egenskapsalternativ.
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 CngPropertyParametrar
- name
- String
Namnet på den önskade egenskapen.
- options
- CngPropertyOptions
En bitvis kombination av uppräkningsvärdena som anger alternativ för den namngivna egenskapen.
Returer
Ett objekt som innehåller råvärdet för den angivna egenskapen.
- Attribut
Undantag
name är null.
Alla andra fel.
Kommentarer
Syftet med den här metoden är att returnera värdet för en godtycklig egenskap för nyckeln. Det vanliga sättet att hämta egenskaper är att använda de egenskapsåtkomster som tillhandahålls av CngKey klassen. CngKey innehåller omslutning för flera, men inte alla, egenskaper. Metoden GetProperty används främst för att komma åt värdet för en egenskap som inte är omsluten.
Den här metoden är användbar i följande fall:
En ny version av operativsystemet stöder en ny CNG-nyckelegenskap (Cryptography Next Generation) som inte har någon omslutning.
Du lägger till en anpassad egenskap i nyckeln.
Parametern options används specifikt för att ange följande:
Om egenskapen är inbyggd eller anpassad.
Om egenskapen ska bevaras med nyckeln.
De här alternativen måste matcha värdet som egenskapen angavs med, annars hittas inte egenskapen.
CryptographicException genereras om egenskapen inte kan hittas. Du bör anropa HasProperty metoden först för att undvika undantaget i stället för att omsluta metodanropet i ett try/catch block.
