Freigeben über

ASP-Cache <cache>

  • Artikel

Übersicht

Das <cache>-Element des <asp>-Elements gibt die folgenden Cacheeinstellungen von Active Server Pages (ASP) für Internetinformationsdienste 7 (Internet Information Services, IIS) an, mit denen das Leistungsverhalten für ASP gesteuert werden kann:

  • Das diskTemplateCacheDirectory-Attribut enthält den Namen des Verzeichnisses, in dem ASP kompilierte ASP-Vorlagen nach Überlauf des Speichercache auf dem Datenträger speichert. Wenn das Standardverzeichnis geändert wird, müssen Sie sicherstellen, dass die Identität der Prozesse, die ASP ausführen, über Vollzugriff auf das neue Verzeichnis verfügt.
  • Das enableTypelibCache-Attribut gibt an, ob Typbibliotheken auf dem Server zwischengespeichert werden.
  • Der Wert des maxDiskTemplateCacheFiles-Attributs gibt an, wie viele kompilierte ASP-Vorlagen maximal gespeichert werden können. (Das Verzeichnis, in dem die kompilierten Vorlagen gespeichert werden, wird durch das diskTemplateCacheDirectory-Attribut konfiguriert.)
  • Das scriptFileCacheSize-Attribut gibt an, wie viele vorkompilierte Skriptdateien zwischengespeichert werden sollen. Falls auf 0 festgelegt, werden keine Skriptdateien zwischengespeichert. Wenn der Wert auf „4.294.967.295“ festgelegt wird, werden alle angeforderten Skriptdateien zwischengespeichert. Dieses Attribut wird verwendet, um die Leistung in Abhängigkeit vom verfügbaren Arbeitsspeicher und vom Skriptdateidatenverkehr zu optimieren.
  • Das scriptEngineCacheMax-Attribut gibt an, wie viele Skript-Engines von ASP-Seiten maximal im Arbeitsspeicher zwischengespeichert werden.

Kompatibilität

Version Hinweise
IIS 10.0 Das <cache>-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <cache>-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Das <cache>-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5 Das <cache>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0 Das <cache>-Element des <asp>-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0 Das <cache>-Element ersetzt die folgenden Metabasiseigenschaften von IIS 6.0:
  • AspDiskTemplateCacheDirectory
  • AspEnableTypelibCache
  • AspMaxDiskTemplateCacheFiles
  • AspScriptEngineCacheMax
  • AspScriptFileCacheSize

Setup

Um ASP-Anwendungen auf Ihrem Webserver zu unterstützen und zu konfigurieren, müssen Sie das ASP-Modul installieren. Führen Sie die folgenden Schritte aus, um das ASP-Modul zu installieren:

Windows Server 2012 oder Windows Server 2012 R2

  1. Klicken Sie auf der Taskleiste auf Server-Manager.
  2. Klicken Sie im Server-Manager auf Verwalten und dann auf Rollen und Features hinzufügen.
  3. Klicken Sie im Assistenten zum Hinzufügen von Rollen und Features auf Weiter. Wählen Sie den Installationstyp aus, und klicken Sie auf Weiter. Wählen Sie den Zielserver aus, und klicken Sie auf Weiter.
  4. Erweitern Sie auf der Seite Serverrollen die Option Webserver (IIS), erweitern Sie Webserver, erweitern Sie Anwendungsentwicklung, und wählen Sie dann ASP aus.
    Screenshot that shows A S P selected for Windows Server 2012.
  5. Wenn das Dialogfeld Features hinzufügen, die von ASP benötigt werden? angezeigt wird, klicken Sie auf Features hinzufügen. (Diese Seite wird nur angezeigt, wenn Sie den Rollendienst für ISAPI-Erweiterungen noch nicht auf Ihrem Server installiert haben.)
  6. Klicken Sie auf der Seite Serverrollen auf Weiter.
  7. Klicken Sie auf der Seite Features auswählen auf Weiter.
  8. Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
  9. Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 8 oder Windows 8.1

  1. Bewegen Sie auf dem Startbildschirm den Mauszeiger ganz nach links unten, klicken Sie mit der rechten Maustaste auf die Schaltfläche Start, und klicken Sie dann auf Systemsteuerung.

  2. Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.

  3. Erweitern Sie Internetinformationsdienste > WWW-Dienste > Anwendungsentwicklungsfeatures, und wählen Sie anschließend ASP aus.
    Screenshot that shows A S P selected for Windows 8.

    Hinweis

    Die Rolle „ISAPI-Erweiterungen“ ist ausgewählt, wenn sie noch nicht installiert wurde.

  4. Klicken Sie auf OK.

  5. Klicken Sie auf Schließen.

Windows Server 2008 oder Windows Server 2008 R2

  1. Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungstools, und klicken Sie dann auf Server-Manager.
  2. Erweitern Sie im Hierarchiebereich Server-Manager die Option Rollen, und klicken Sie dann auf Webserver (IIS).
  3. Scrollen Sie im Bereich Webserver (IIS) zum Abschnitt Rollendienste, und klicken Sie dann auf Rollendienste hinzufügen.
  4. Wählen Sie im Assistenten zum Hinzufügen von Rollendiensten auf der Seite Rollendienste auswählen die Option ASP aus.
    Screenshot that shows the Select Role Services page in the Add Role Services dialog box. A S P is selected under the Application Development node.
  5. Wenn das Dialogfeld Rollendienste hinzufügen, die von ASP benötigt werden angezeigt wird, klicken Sie auf Erforderliche Rollendienste hinzufügen. (Diese Seite wird nur angezeigt, wenn Sie den Rollendienst für ISAPI-Erweiterungen noch nicht auf Ihrem Server installiert haben.)
    Screenshot that shows the Add Role Services message box.
  6. Klicken Sie auf der Seite Rollendienste auswählen auf Weiter.
  7. Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
  8. Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows Vista oder Windows 7

  1. Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
  2. Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
  3. Erweitern Sie Internetinformationsdienste > WWW-Dienste > Anwendungsentwicklungsfeatures.
  4. Wählen Sie ASP aus, und klicken Sie anschließend auf OK.
    Screenshot that shows A S P selected for Windows 7.

Gewusst wie

Konfigurieren der ASP-Cacheeinstellungen für einen Server

  1. Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):

    • Vorgehensweise unter Windows Server 2012 oder Windows Server 2012 R2:

      • Klicken Sie auf der Taskleiste auf Server-Manager > Tools > Internetinformationsdienste-Manager (IIS-Manager).

    • Vorgehensweise unter Windows 8 oder Windows 8.1:

      • Halten Sie die WINDOWS-TASTE gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf Systemsteuerung.
      • Klicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

    • Vorgehensweise unter Windows Server 2008 oder Windows Server 2008 R2:

      • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

    • Vorgehensweise unter Windows Vista oder Windows 7:

      • Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
      • Doppelklicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

  2. Markieren Sie im Bereich Verbindungen den Namen Ihres Servers.

  3. Doppelklicken Sie im Bereich Start des Servers auf ASP.
    Screenshot that shows the Server Home pane. A S P is selected.

  4. Erweitern Sie im Bereich ASP den Abschnitt Caching-Eigenschaften, konfigurieren Sie die gewünschten Einstellungen, und klicken Sie dann im Bereich Aktionen auf Anwenden.
    Screenshot that shows the A S P pane. Caching Properties is selected and expanded.

Konfiguration

Attribute

Attribut Beschreibung
diskTemplateCacheDirectory Optionales Zeichenfolgeattribut.

Gibt den Namen des Verzeichnisses an, in dem ASP kompilierte ASP-Vorlagen speichert, wenn der In-Memory-Cache überläuft.

Der Standardwert ist %SystemDrive%\inetpub\temp\ASP Compiled Templates.
enableTypelibCache Optionales boolesches Attribut.

Gibt an, ob Typbibliotheken zwischengespeichert werden.

Der Standardwert ist true.
maxDiskTemplateCacheFiles Optionales uint-Attribut.

Gibt an, wie viele kompilierte ASP-Vorlagen maximal gespeichert werden können. Dieser Wert ist eine ganze Zahl zwischen 0 und 2.147.483.647.

Der Standardwert ist 2000.
scriptEngineCacheMax Optionales uint-Attribut.

Gibt an, wie viele Skript-Engines von ASP-Seiten maximal im Arbeitsspeicher zwischengespeichert werden. Dieser Wert ist eine ganze Zahl zwischen 0 und 2.147.483.647.

Der Standardwert ist 250.
scriptFileCacheSize Optionales uint-Attribut.

Gibt an, wie viele vorkompilierte Skriptdateien zwischengespeichert werden sollen. Falls auf 0 festgelegt, werden keine Skriptdateien zwischengespeichert. Wenn der Wert auf „4.294.967.295“ festgelegt wird, werden alle angeforderten Skriptdateien zwischengespeichert. Dieses Attribut wird verwendet, um die Leistung in Abhängigkeit vom verfügbaren Arbeitsspeicher und vom Skriptdateidatenverkehr zu optimieren.

Der Standardwert ist 500.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird das Verzeichnis für den ASP-Vorlagencache festgelegt. Außerdem wird die maximale Anzahl kompilierter ASP-Vorlagen, die gespeichert werden können, auf „400“ festgelegt, die Anzahl vorkompilierter Skriptdateien, die zwischengespeichert werden sollen, wird auf „1.000“ festgelegt, und die maximale Anzahl von Skriptmodulen, die von ASP-Seiten im Arbeitsspeicher zwischengespeichert werden, wird auf „500“ festgelegt.

<configuration>
   <system.webServer>
      <asp>
         <cache maxDiskTemplateCacheFiles="4000"
            diskTemplateCacheDirectory="%SystemDrive%\inetpub\temp\ASP Compiled Templates"
            scriptFileCacheSize="1000"
            scriptEngineCacheMax="500"
         />
      </asp>
   </system.webServer>
</configuration>

Beispielcode

In den folgenden Codebeispielen wird das Verzeichnis für den ASP-Vorlagencache festgelegt. Außerdem wird die maximale Anzahl kompilierter ASP-Vorlagen, die gespeichert werden können, auf „400“ festgelegt, die Anzahl vorkompilierter Skriptdateien, die zwischengespeichert werden sollen, wird auf „1.000“ festgelegt, und die maximale Anzahl von Skriptmodulen, die von ASP-Seiten im Arbeitsspeicher zwischengespeichert werden, wird auf „500“ festgelegt.

AppCmd.exe

appcmd.exe set config -section:system.webServer/asp /cache.diskTemplateCacheDirectory:"%SystemDrive%\inetpub\temp\ASP Compiled Templates" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.maxDiskTemplateCacheFiles:"4000" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.scriptFileCacheSize:"1000" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.scriptEngineCacheMax:"500" /commit:apphost

Hinweis

Legen Sie den commit-Parameter auf apphost fest, wenn Sie „AppCmd.exe“ verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei „ApplicationHost.config“ festgelegt.

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.GetApplicationHostConfiguration();
         ConfigurationSection aspSection = config.GetSection("system.webServer/asp");

         ConfigurationElement cacheElement = aspSection.GetChildElement("cache");
         cacheElement["diskTemplateCacheDirectory"] = @"%SystemDrive%\inetpub\temp\ASP Compiled Templates";
         cacheElement["maxDiskTemplateCacheFiles"] = 4000;
         cacheElement["scriptFileCacheSize"] = 1000;
         cacheElement["scriptEngineCacheMax"] = 500;

         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.GetApplicationHostConfiguration
      Dim aspSection As ConfigurationSection = config.GetSection("system.webServer/asp")

      Dim cacheElement As ConfigurationElement = aspSection.GetChildElement("cache")
      cacheElement("diskTemplateCacheDirectory") = "%SystemDrive%\inetpub\temp\ASP Compiled Templates"
      cacheElement("maxDiskTemplateCacheFiles") = 4000
      cacheElement("scriptFileCacheSize") = 1000
      cacheElement("scriptEngineCacheMax") = 500

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST");

var cacheElement = aspSection.ChildElements.Item("cache");
cacheElement.Properties.Item("diskTemplateCacheDirectory").Value = "%SystemDrive%\\inetpub\\temp\\ASP Compiled Templates";
cacheElement.Properties.Item("maxDiskTemplateCacheFiles").Value = 4000;
cacheElement.Properties.Item("scriptFileCacheSize").Value = 1000;
cacheElement.Properties.Item("scriptEngineCacheMax").Value = 500;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST")

Set cacheElement = aspSection.ChildElements.Item("cache")
cacheElement.Properties.Item("diskTemplateCacheDirectory").Value = "%SystemDrive%\inetpub\temp\ASP Compiled Templates"
cacheElement.Properties.Item("maxDiskTemplateCacheFiles").Value = 4000
cacheElement.Properties.Item("scriptFileCacheSize").Value = 1000
cacheElement.Properties.Item("scriptEngineCacheMax").Value = 500

adminManager.CommitChanges()