<nameEntry>-Element

Artikel
08/20/2008

Aktualisiert: November 2007

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.

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

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe des <nameEntry>-Elements auf eine Kryptografieklasse verweisen und die Laufzeit konfigurieren. Sie können dann die Zeichenfolge "RSA" an die CryptoConfig.CreateFromName-Methode übergeben und mithilfe der Create-Methode 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>