Esporta (0) Stampa
Espandi tutto

Metodo CngKey.GetProperty

Aggiornamento: novembre 2007

Ottiene una proprietà, dato un nome e un insieme di opzioni della proprietà.

Spazio dei nomi:  System.Security.Cryptography
Assembly:  System.Core (in System.Core.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode = true)]
public CngProperty GetProperty(
	string name,
	CngPropertyOptions options
)
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode = true) */
public CngProperty GetProperty(
	String name,
	CngPropertyOptions options
)
public function GetProperty(
	name : String, 
	options : CngPropertyOptions
) : CngProperty

Parametri

name
Tipo: System.String

Nome della proprietà desiderata.

options
Tipo: System.Security.Cryptography.CngPropertyOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni per la proprietà denominata.

Valore restituito

Tipo: System.Security.Cryptography.CngProperty

Oggetto contenente il valore non elaborato della proprietà specificata.

EccezioneCondizione
ArgumentNullException

name è null.

CryptographicException

Tutti gli altri errori.

Lo scopo di questo metodo è restituire il valore di una proprietà arbitraria della chiave. Un modo tipico per recuperare le proprietà consiste nell'utilizzo delle funzioni di accesso della proprietà fornite dalla classe CngKey. CngKey fornisce wrapper per molte proprietà, ma non per tutte. Il metodo GetProperty viene utilizzato principalmente per accedere al valore di una proprietà di cui non viene eseguito il wrapping.

Questo metodo è utile nei casi seguenti:

  • Una nuova versione del sistema operativo supporta una nuova proprietà della chiave CNG (Cryptography Next Generation) che non dispone di un wrapper.

  • Viene aggiunta una proprietà personalizzata alla chiave.

Il parametro options viene specificamente utilizzato per indicare quanto segue:

  • Se la proprietà è incorporata o personalizzata.

  • Se la proprietà deve essere salvata in modo permanente con la chiave.

Queste opzioni devono corrispondere al valore con il quale è stata impostata la proprietà, altrimenti questa non verrà trovata.

L'eccezione CryptographicException viene generata se non è possibile individuare la proprietà. È necessario innanzitutto chiamare il metodo HasProperty per evitare l'eccezione, anziché eseguire il wrapping della chiamata al metodo in un blocco try/catch.

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft