Elemento <nameEntry>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Esegue il mapping del nome di una classe su un nome di algoritmo descrittivo consentendo l'uso di più nomi descrittivi per un'unica classe.

Elemento <Configuration>
  Elemento <mscorlib> per le impostazioni di crittografia
    Elemento <cryptographySettings>
      Elemento <cryptoNameMapping>
        Elemento <nameEntry>

<nameEntry name="friendly name" Class="class name" />

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
name	Attributo obbligatorio. Specifica il nome descrittivo dell'algoritmo implementato dalla classe di crittografia.
class	Attributo obbligatorio. Specifica il valore per l'attributo name nell'elemento <cryptoClass>.

name

Attributo obbligatorio.

Specifica il nome descrittivo dell'algoritmo implementato dalla classe di crittografia.

class

Attributo obbligatorio.

Specifica il valore per l'attributo name nell'elemento <cryptoClass>.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.

Note

L'attributo name può essere il nome di una delle classi astratte individuate nello spazio dei nomi System.Security.Cryptography. Quando si chiama il metodo Create su una classe astratta di crittografia, il nome di tale classe viene passato al metodo Security.CryptoConfig.CreateFromName. CreateFromName restituisce un'istanza del tipo indicato dall'attributo class. Se l'attributo name è un nome breve, ad esempio RSA, è possibile utilizzare tale nome quando si chiama il metodo CreateFromName.

Esempio

Nell'esempio seguente viene illustrato come utilizzare l'elemento <nameEntry> per fare riferimento a una classe di crittografia e configurare il runtime. È quindi possibile passare la stringa "RSA" al metodo CryptoConfig.CreateFromName e utilizzare il metodo Create per restituire un oggetto MyCryptoRSAClass.

<configuration>
   <mscorlib>
      <cryptographySettings>
         <cryptoNameMapping>
            <cryptoClasses>
               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly
                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,
                  Version=1.0.0.0"/>
            </cryptoClasses>
            <nameEntry name="RSA" class="MyCryptoRSA"/>
            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"
                       class="MyCryptoRSA"/>
         </cryptoNameMapping>
      </cryptographySettings>
   </mscorlib>
</configuration>