<nameEntry> 元素

项目
08/18/2008

更新：2007 年 11 月

将类名映射为友好算法名称，这样允许一个类具有多个友好名称。

<configuration> 元素
   加密设置的 <mscorlib> 元素
     <cryptographySettings> 元素
       <cryptoNameMapping> 元素
         <nameEntry> 元素

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

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性	说明
name	必需的属性。指定密码类实现的算法的友好名称。
class	必需的属性。指定 <cryptoClass> 元素中的 name 属性的值。

name

必需的属性。

指定密码类实现的算法的友好名称。

class

必需的属性。

指定 <cryptoClass> 元素中的 name 属性的值。

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.web	为 ASP.NET 配置节指定根元素。

备注

name 属性可以是位于 System.Security.Cryptography 命名空间中的某个抽象类的名称。在抽象密码类上调用 Create 方法时，抽象类名称被传递给 Security.CryptoConfig.CreateFromName 方法。CreateFromName 返回由 class 属性指示的类型的实例。如果 name 属性是简称（如 RSA），则可以在调用 CreateFromName 方法时使用该名称。

示例

下面的示例演示如何使用 <nameEntry> 元素来引用密码类和配置运行库。然后，您就可以将字符串“RSA”传递到 CryptoConfig.CreateFromName 方法并使用 Create 方法返回一个 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>