Elemento <nameEntry>

Articolo
08/22/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 riportato di seguito viene illustrato come utilizzare l'elemento <nameEntry> per eseguire il mapping di una classe di crittografia su un nome di algoritmo descrittivo. In questo esempio l'ambiente di esecuzione viene configurato in modo che System.Security.CryptoConfig.CreateFromName("RSA") e System.Security.Cryptography.AsymmetricAlgorithm.Create in un'applicazione restituiscano 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>

Vedere anche

Riferimenti

Schema delle impostazioni di crittografia

Altre risorse

Schema dei file di configurazione per .NET Framework
Servizi di crittografia
Configurazione di classi di crittografia

Condividi tramite