<nameEntry>, élément

Article
08/21/2008

Mise à jour : novembre 2007

Associe un nom de classe à un nom d'algorithme convivial, ce qui permet à une seule classe d'avoir plusieurs noms conviviaux.

<configuration>, élément
  <mscorlib>, élément pour les paramètres de chiffrement
    <cryptographySettings>, élément
      <cryptoNameMapping>, élément
        <nameEntry>, élément

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
name	Attribut requis. Spécifie le nom convivial de l'algorithme que la classe de chiffrement implémente.
class	Attribut requis. Spécifie la valeur de l'attribut name dans l'élément <cryptoClass>.

name

Attribut requis.

Spécifie le nom convivial de l'algorithme que la classe de chiffrement implémente.

class

Attribut requis.

Spécifie la valeur de l'attribut name dans l'élément <cryptoClass>.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

L'attribut name peut être le nom de l'une des classes abstraites trouvées dans l'espace de noms System.Security.Cryptography. Lorsque vous appelez la méthode Create sur une classe de chiffrement abstraite, le nom de la classe abstraite est passé à la méthode Security.CryptoConfig.CreateFromName. CreateFromName retourne une instance du type indiqué par l'attribut class. Si l'attribut name est un nom court, tel que RSA, vous pouvez utiliser ce nom lors de l'appel de la méthode CreateFromName.

Exemple

L'exemple suivant illustre l'utilisation de l'élément <nameEntry> pour référencer une classe de chiffrement et configurer le runtime. Vous pouvez ensuite passer la chaîne "RSA" à la méthode CryptoConfig.CreateFromName et utiliser la méthode Create pour retourner un objet 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>