<nameEntry> 要素

  • [アーティクル]

アルゴリズムの表示名にクラス名をマップして、1 つのクラスが多くの表示名を持つことを許可します。

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

構文

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
name 必須の属性です。

暗号化クラスが実装するアルゴリズムの表示名を指定します。
class 必須の属性です。

<cryptoClass> 要素の name 属性の値を指定します。

子要素

なし。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.web ASP.NET 構成セクションのルート要素を指定します。

解説

name 属性には、System.Security.Cryptography 名前空間で見つかった抽象クラスの 1 つの名前を指定できます。 抽象暗号化クラスで Create メソッドを呼び出すと、抽象クラス名が 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>

関連項目