<nameEntry> 項目

發行項
08/21/2008

更新：2007 年 11 月

將類別名稱對應至易記的演算法名稱，允許一個類別有許多易記名稱。

<configuration> 項目
   密碼編譯設定的 <mscorlib> 項目
     <cryptographySettings> 項目
       <cryptoNameMapping> 項目
         <nameEntry> 項目

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

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性	描述
name	必要的屬性。指定密碼編譯類別實作的演算法易記名稱。
class	必要的屬性。指定 <cryptoClass> 項目中的 name 屬性值。

name

必要的屬性。

指定密碼編譯類別實作的演算法易記名稱。

class

必要的屬性。

指定 <cryptoClass> 項目中的 name 屬性值。

子項目

無

父項目

項目	描述
configuration	每一個組態檔中的根 (Root) 項目是由 Common Language Runtime 和 .NET Framework 應用程式所使用的。
system.web	指定 ASP.NET 組態區段的根項目。

備註

name 屬性可以是 System.Security.Cryptography 命名空間中所找到的抽象類別的其中一個名稱。當您在抽象密碼編譯類別上呼叫 Create 方法時，抽象類別名稱會傳遞給 Security.CryptoConfig.CreateFromName 方法。CreateFromName 會傳回 class 屬性所指示的型別執行個體 (Instance)。如果 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>