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

Übersicht

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

Kompatibilität

Setup

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

Gewusst wie

Hinzufügen eines verwalteten Moduls zur Anwendung

1. Ö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.

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

3. Doppelklicken Sie im Startbereich auf Module.
   

4. Klicken Sie im Bereich „Aktionen“ auf Verwaltetes Modul Hinzufügen.

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

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

7. Klicken Sie auf OK.

Konfiguration

Attribute

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

• Ö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()