<nameEntry>-Element

  • Artikel

Ordnet einen Klassennamen einem angezeigten Algorithmusnamen zu, wodurch eine Klasse viele angezeigte Namen aufweisen kann.

<configuration>-Element
  <mscorlib>-Element für Kryptografieklassen
    <cryptographySettings>-Element
      <cryptoNameMapping>-Element
        <nameEntry>-Element

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut Beschreibung

name

Erforderliches Attribut.

Gibt den angezeigten Namen des Algorithmus an, den die Kryptografieklasse implementiert.

class

Erforderliches Attribut.

Gibt den Wert für das name‑Attribut im <cryptoClass>-Element an.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element Beschreibung

configuration

Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.web

Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Das name-Attribut kann der Name einer der abstrakten Klassen im System.Security.Cryptography-Namespace sein. Wenn die Create-Methode in einer abstrakten Kryptografieklasse aufgerufen wird, wird der Name der abstrakten Klasse an die Security.CryptoConfig.CreateFromName-Methode übergeben. CreateFromName gibt eine Instanz des Typs zurück, der durch das class-Attribut angegeben wird. Wenn das name-Attribut ein Kurzname ist, z. B. RSA, können Sie den Namen beim Aufrufen der CreateFromName-Methode verwenden.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie das <nameEntry>-Element verwenden können, um eine Kryptografieklasse einem angezeigten Algorithmusnamen zuzuordnen. In diesem Beispiel wird die Laufzeit so konfiguriert, dass System.Security.CryptoConfig.CreateFromName("RSA") und System.Security.Cryptography.AsymmetricAlgorithm.Create in einer Anwendung ein MyCryptoRSAClass-Objekt zurückgeben.

<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>

Siehe auch

Referenz

Schema für Kryptografieeinstellungen

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework
Kryptografische Dienste
Konfigurieren kryptografischer Klassen