Элемент <nameEntry>

Статья
11/16/2008

Обновлен: Ноябрь 2007

Сопоставляет имя класса с понятным именем алгоритма, позволяющим одному классу иметь несколько понятных имен.

Элемент <configuration>
  Элемент <mscorlib> для параметров криптографии
    Элемент <cryptographySettings>
      Элемент <cryptoNameMapping>
        Элемент <nameEntry>

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

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
name	Обязательный атрибут. Задание понятного имени алгоритма, реализуемого в криптографическом классе.
class	Обязательный атрибут. Задание значение для атрибута name в элементе <cryptoClass>.

name

Обязательный атрибут.

Задание понятного имени алгоритма, реализуемого в криптографическом классе.

class

Обязательный атрибут.

Задание значение для атрибута name в элементе <cryptoClass>.

Дочерние элементы

Нет.

Родительские элементы

Элемент	Описание
configuration	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .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>