Elemento <nameEntry>

Artigo
05/10/2023

Mapeia um nome de classe para um nome de algoritmo amigável, o que permite que uma classe tenha vários nomes amigáveis.

<configuração>
  <mscorlib>
    <cryptographySettings>
      <cryptoNameMapping>
        <nameEntry>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
name	Atributo obrigatório. Especifica o nome amigável do algoritmo que a classe de criptografia implementa.
class	Atributo obrigatório. Especifica o valor do atributo name no elemento <cryptoClass>.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
`configuration`	O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
`system.web`	Especifica o elemento raiz da seção de configuração do ASP.NET.

Comentários

O atributo name pode ser o nome de uma das classes abstratas encontradas no namespace System.Security.Cryptography. Quando você chama o método Create em uma classe de criptografia abstrata, o nome da classe abstrata é passado para o método CreateFromName. CreateFromName retorna uma instância do tipo indicado pelo atributo de class. Se o atributo name for um nome curto, como RSA, você poderá usar esse nome ao chamar o método CreateFromName.

Exemplo

O exemplo a seguir mostra como usar o elemento <nameEntry> para fazer referência a uma classe de criptografia e configurar o runtime. Em seguida, você poderá passar a cadeia de caracteres "RSA" para o método CryptoConfig.CreateFromName e usar o método Create para retornar um 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>

Compartilhar via