Elemento <nameEntry>

Artículo
05/10/2023

Asigna un nombre de clase a un nombre de algoritmo descriptivo, que permite que una clase tenga varios nombres descriptivos.

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

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
name	Atributo necesario. Especifica el nombre descriptivo del algoritmo que implementa la clase de criptografía.
class	Atributo necesario. Especifica el valor del atributo name en el elemento <cryptoClass>.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
`configuration`	Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
`system.web`	Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

El atributo name puede ser el nombre de una de las clases abstractas que se encuentran en el espacio de nombres System.Security.Cryptography. Cuando se llama al método Create en una clase de criptografía abstracta, el nombre de clase abstracta se pasa al método CreateFromName. CreateFromName devuelve una instancia del tipo indicado por el atributo de clase. Si el atributo name es un nombre corto, como RSA, puede usar ese nombre al llamar al método CreateFromName.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el elemento <nameEntry> para hacer referencia a una clase de criptografía y para configurar el tiempo de ejecución. A continuación, puede pasar la cadena "RSA" al método CryptoConfig.CreateFromName y usar el método Create para devolver un objeto 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>

Compartir vía