<nameEntry> 元素
將類別名稱對應至易記的演算法名稱,允許一個類別有許多易記名稱。
<設定>
<mscorlib>
<cryptographySettings>
<cryptoNameMapping>
<nameEntry>
Syntax
<nameEntry name="friendly name" Class="class name" />
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
屬性 | 描述 |
---|---|
name | 必要屬性。 指定加密類別實作演算法的自訂名稱。 |
class | 必要屬性。 指定 <cryptoClass> 元素的名稱屬性值。 |
子元素
無。
父項目
元素 | Description |
---|---|
configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
備註
名稱屬性可為 System.Security.Cryptography 命名空間找到的其中一個抽象類別名稱。 當您在抽象加密類別呼叫建立方法時,抽象類別名稱會傳遞至 CreateFromName 方法。 CreateFromName 所傳回的執行個體型別為類別屬性所指示者。 如果名稱屬性是簡短名稱,例如 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>