Gewusst wie: Importieren einer Codegruppe mithilfe einer XML-Datei

  • Artikel

Aktualisiert: November 2007

Möglicherweise ist es für eine Anwendung erforderlich, den Sicherheitsrichtlinien eine anwendungsspezifische Codegruppe hinzuzufügen. Im Lieferumfang der Anwendung kann eine Assembly enthalten sein, die die neue Codegruppe implementiert, sowie eine XML-Datei, die eine Serialisierung der neuen Codegruppe enthält. Die XML-Datei kann mithilfe des .NET Framework-Konfigurationstools (Mscorcfg.msc) in die Sicherheitsrichtlinien importiert werden. Die XML-Datei enthält ggf. außerdem Informationen über die Memberbedingung und den Berechtigungssatz, die der Codegruppe zugeordnet sind. In den meisten Fällen erfüllt die Anwendung die angegebene Memberbedingung und benötigt den zugeordneten Berechtigungssatz.

Das folgende Beispiel veranschaulicht, wie Informationen für eine Codegruppe und die zugeordnete Memberbedingung sowie für den zugeordneten Berechtigungssatz in einer XML-Datei angezeigt werden können.

Beispiel

<CodeGroup class="System.Security.Policy.UnionCodeGroup, mscorlib,
           Version=1.0.2411.0, Culture=neutral,
           PublicKeyToken=b77a5c561934e089" version="1"
           Name="myCodeGroup"
           Description="test code group">
   <IMembershipCondition class="MyCustomMembershipCondition, myAssembly,
       Version=1.0.0.0, Culture=neutral,
       PublicKeyToken=b77a5c561934e089" version="1"
       Url="https://www.microsoft.com/"/>
 
   <PermissionSet class="NamedPermissionSet" version="1"
       Name="MyPermissionSet"
       Description="Permission set containing my custom permission">
          <IPermission class="myCustomNamespace.CustomPermission,
             customPerm, Version=0.0.0.0, Culture=neutral,
             PublicKeyToken=64a85a7d791b1a32"  version="1"
             Unrestricted="True"/>
   </PermissionSet>
</CodeGroup>

Das <CodeGroup>-Element enthält Informationen für eine neue Codegruppe. Das class-Attribut und das version-Attribut ist für das <CodeGroup>-Element erforderlich. Das class-Attribut verweist auf die Klasse und Assembly, die die neue Codegruppe implementieren. Der Wert des class-Attributs kann jedes der in Angeben vollständig gekennzeichneter Typnamen erläuterten Formate aufweisen, hat jedoch i. d. R. das im Beispiel dargestellte Format. Für diese Version von .NET Framework lautet das version-Attribut "1". Das Name-Attribut und das Description-Attribut können aus jeder gültigen Zeichenfolge bestehen und bearbeitet werden. Das Name-Attribut ist der Name des Berechtigungssatzes, wie er im .NET Framework-Konfigurationstool angezeigt wird.

Das <IMembershipCondition>-Element enthält Attribute oder untergeordnete Elemente, die die Bedingung angeben, die von Assemblys erfüllt werden müssen, um Member der Codegruppe zu werden und die zugeordneten Berechtigungen zu erhalten. Das class-Attribut für <IMembershipCondition> hat dasselbe Format wie das class-Attribut für <CodeGroup>.

Wenn ein <CodeGroup>-Element ein <IMembershipCondition>-Element und ein <PermissionSet> -Element enthält, werden der Codegruppe die Mitgliedschaftsbedingungen und -berechtigungen beim Importieren automatisch zugeordnet. Wenn eines dieser Elemente fehlt, müssen Sie das fehlende Element der neuen Codegruppe mithilfe des .NET Framework-Konfigurationstools (Mscorcfg.msc) zuordnen. Weitere Informationen finden Sie unter Konfigurieren von Codegruppen mit dem .NET Framework-Konfigurationstool.

Siehe auch

Weitere Ressourcen

Verwaltung der Sicherheitsrichtlinien

Importieren von Sicherheitskomponenten mithilfe von XML-Dateien