<nameEntry>-Element

Artikel
05/26/2023

Ordnet einen Klassennamen dem Anzeigenamen eines Algorithmus zu. Dadurch kann eine Klasse über viele Anzeigenamen verfügen.

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

Syntax

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

Attribute und Elemente

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

Attribute

attribute	BESCHREIBUNG
name	Erforderliches Attribut. Gibt den Anzeigenamen 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 von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`system.web`	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Bemerkungen

Das name-Attribut kann der Name einer der abstrakten Klassen sein, die im System.Security.Cryptography-Namespace zu finden sind. Wenn Sie die Create-Methode für eine abstrakte Kryptografieklasse aufrufen, wird der Name der abstrakten Klasse an die 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 diesen Namen beim Aufrufen der CreateFromName-Methode verwenden.

Beispiel

Das folgende Beispiel zeigt, wie Sie das <nameEntry>-Element verwenden, um auf eine Kryptografieklasse zu verweisen und die Runtime zu konfigurieren. Anschließend können Sie die Zeichenfolge „RSA“ an die CryptoConfig.CreateFromName-Methode übergeben und die Create-Methode verwenden, um ein MyCryptoRSAClass-Objekt zurückzugeben.

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

Freigeben über