<nameEntry>, élément

Article
05/10/2023

Mappe un nom de classe à un nom d’algorithme convivial, ce qui permet à une classe d’avoir plusieurs noms conviviaux.

<configuration>
  <mscorlib>
    <cryptographySettings>
      <cryptoNameMapping>
        <nameEntry>

Syntaxe

<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 implémenté par la classe de chiffrement.
class	Attribut requis. Spécifie la valeur de l’attribut name dans l’élément <cryptoClass>.

Éléments enfants

Aucune.

É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 se trouvant dans l’espace de noms System.Security.Cryptography. Quand vous appelez la méthode Create sur une classe de chiffrement abstraite, le nom de la classe abstraite est transmis à la méthode CreateFromName. CreateFromName retourne une instance du type indiqué par l’attribut class. Si l’attribut name est un nom court, comme RSA, vous pouvez utiliser ce nom au moment d’appeler la méthode CreateFromName.

Exemple

L’exemple suivant montre comment utiliser l’élément <nameEntry> pour référencer une classe de chiffrement et configurer le runtime. Vous pouvez ensuite transmettre 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>

Partager via