Add Modules <add> element for Internetinformationsdienste (IIS) 7;

Artikel
04/24/2024

Übersicht

Das <add>-Element der <modules>-Auflistung fügt der Liste der Module für Internetinformationsdienste (IIS) 7 ein Modul hinzu.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<add>` Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<add>` Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<add>` Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<add>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<add>`-Element der `<modules>`-Auflistung wurde in IIS 7.0 eingeführt.
IIS 6.0	N/V

Setup

Das <add>-Element der <modules>-Auflistung ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Hinzufügen eines verwalteten Moduls zur Anwendung

Öffnen Sie den Internet Information Services (IIS) Manager:
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
  - Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Erweitern Sie im Bereich Verbindungen den Servernamen, erweitern Sie Websites, und wechseln Sie dann zur Website oder Anwendung, der Sie ein verwaltetes Modul hinzufügen möchten.
Doppelklicken Sie im Startbereich auf Module.
Klicken Sie im Bereich „Aktionen“ auf Verwaltetes Modul Hinzufügen.
Geben Sie im Dialogfeld Verwaltetes Modul hinzufügen den Namen des verwalteten Moduls im Feld Name ein, und geben Sie dann im Feld "Typ" den vollqualifizierten .NET Framework-Typ des Moduls ein.
Wählen Sie die Option Nur aufrufen für Anforderungen an ASP.NET Anwendungen oder verwaltete Handler aus, wenn das Modul nur auf verwaltete Anforderungen reagieren soll.
Klicken Sie auf OK.

Konfiguration

Attribute

Attribut Beschreibung

name Erforderliches Zeichenfolgenattribut.

Gibt den eindeutigen Namen eines verwalteten Moduls auf dem Webserver an.

preCondition

Optionales Zeichenfolgeattribut. Gibt Bedingungen an, unter denen das Modul ausgeführt wird.

Das Attribut preCondition kann einer oder mehrere der folgenden möglichen Werte sein. Wenn Sie mehrere Werte angeben, trennen Sie die Werte durch ein Komma (,).

Wert	Beschreibung
`bitness32`	Geben Sie den Bitness32-Wert an, wenn das Modul eine 32-Bit-.dll Datei ist. IIS sollte den Handler nur für Arbeitsprozesse laden, die im WOW64-Modus (32-Bit-Simulation) auf einem 64-Bit-Betriebssystem ausgeführt werden.
`bitness64`	Geben Sie den Bitness64-Wert an, wenn das Modul eine 64-Bit-.dll-Datei ist. IIS sollte den Handler nur für Arbeitsprozesse laden, die im 64-Bit-Modus ausgeführt werden.
`integratedMode`	Geben Sie den integratedMode-Wert an, wenn das Modul nur auf Anforderungen in Anwendungspools reagieren soll, die für die Verwendung der integrierten Anforderungsverarbeitungspipeline konfiguriert sind.
`ISAPIMode`	Geben Sie den ISAPIModeWert an, wenn das Modul nur auf Anforderungen in Anwendungspools reagieren soll, die für die Verwendung des klassischen Modus konfiguriert sind.
`managedHandler`	Geben Sie den Wert managedHandler an, wenn das Modul Anforderungen nur für verwaltete Ressourcen verarbeiten soll, z. B. .aspx-Dateien, und nicht auf Anforderungen für nicht verwaltete Ressourcen reagieren sollte, z. B. .html-Dateien.
`runtimeVersionv1.1`	Geben Sie den Wert runtimeVersionv1.1 an, wenn das Modul nur auf Anforderungen in Anwendungspools reagieren soll, die für die Verwendung von .NET Framework, Version 1.1 konfiguriert sind.
`runtimeVersionv2.0`	Geben Sie den Wert runtimeVersionv2.0 an, wenn das Modul nur auf Anforderungen in Anwendungspools reagieren soll, die für die Verwendung von .NET Framework, Version 2.0 konfiguriert sind.
`runtimeVersionv4.0`	Geben Sie den wert "runtimeVersionv4.0" an, wenn das Modul nur auf Anforderungen in Anwendungspools reagieren soll, die für die Verwendung von .NET Framework, Version 4.0 konfiguriert sind.

type Optionales Zeichenfolgeattribut.

Gibt den verwalteten Typ eines verwalteten Moduls an. Das Typ-Attribut gilt nicht für systemeigene Module.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im Beispiel wird ein Modul für eine Webanwendung konfiguriert, die im integrierten IIS 7-Modus ausgeführt wird.

<configuration>
   <system.webServer>
      <modules>
         <add name="Header" type="Contoso.ShoppingCart.Header"/>
      </modules>
   </system.webServer>
</configuration>

Beispielcode

Hinweis

Die Beispiele in diesem Dokument veranschaulichen die Verwendung einer Assembly mit verwaltetem Code, die im globalen .NET-Assemblycache (GAC) gespeichert wurde. Bevor Sie den Code in diesen Beispielen zum Bereitstellen eigener Assemblys verwenden, müssen Sie die Assemblyinformationen aus dem GAC abrufen. Führen Sie dazu die folgenden Schritte aus:

Öffnen Sie im Windows-Explorer den Pfad C:\Windows\assembly, wobei C: Ihr Betriebssystemlaufwerk ist.
Suchen Sie Ihre Assembly.
Klicken Sie mit der rechten Maustaste auf die Assembly, und klicken Sie auf Eigenschaften.
Kopieren Sie den Wert Kultur; Beispiel: Neutral.
Kopieren Sie die Version-Nummer, z. B. 1.0.0.0.
Kopieren Sie den Wert Public Key Token, z. B. 426f62526f636b73.
Klicken Sie auf Abbrechen.

Die folgenden Codebeispiele ermöglichen ein verwaltetes Modul für eine Website mit dem Namen Contoso. Die Name-Eigenschaft definiert den Namen CartHeader für das Modul, die Typ-Eigenschaft definiert den verwalteten Typ für das Modul, die preCondition-Eigenschaft definiert, dass IIS das Modul nur für verwaltete Anforderungen aufruft.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/modules /+"[name='CartHeader',type='Contoso.ShoppingCart.Header',preCondition='managedHandler']"

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Contoso");
         ConfigurationSection modulesSection = config.GetSection("system.webServer/modules");
         ConfigurationElementCollection modulesCollection = modulesSection.GetCollection();

         ConfigurationElement addElement = modulesCollection.CreateElement("add");
         addElement["name"] = @"CartHeader";
         addElement["type"] = @"Contoso.ShoppingCart.Header";
         addElement["preCondition"] = @"managedHandler";
         modulesCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim modulesSection As ConfigurationSection = config.GetSection("system.webServer/modules")
      Dim modulesCollection As ConfigurationElementCollection = modulesSection.GetCollection

      Dim addElement As ConfigurationElement = modulesCollection.CreateElement("add")
      addElement("name") = "CartHeader"
      addElement("type") = "Contoso.ShoppingCart.Header"
      addElement("preCondition") = "managedHandler"
      modulesCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso");
var modulesCollection = modulesSection.Collection;

var addElement = modulesCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "CartHeader";
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header";
addElement.Properties.Item("preCondition").Value = "managedHandler";
modulesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso")
Set modulesCollection = modulesSection.Collection

Set addElement = modulesCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "CartHeader"
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header"
addElement.Properties.Item("preCondition").Value = "managedHandler"
modulesCollection.AddElement addElement

adminManager.CommitChanges()

Freigeben über