Aggiunta di profili <di memorizzazione nella cache>
Panoramica
L'elemento <add> dell'elemento <profiles> aggiunge un profilo di memorizzazione nella cache di output alla raccolta di profili di memorizzazione nella cache di output.
Compatibilità
| Versione | Note |
|---|---|
| IIS 10.0 | L'elemento <add> non è stato modificato in IIS 10.0. |
| IIS 8,5 | L'elemento <add> non è stato modificato in IIS 8.5. |
| IIS 8,0 | L'elemento <add> non è stato modificato in IIS 8.0. |
| IIS 7,5 | L'elemento <add> non è stato modificato in IIS 7.5. |
| IIS 7.0 | L'elemento <add> dell'elemento <profiles> è stato introdotto in IIS 7.0. |
| IIS 6.0 | N/D |
Installazione
L'elemento <add> dell'elemento è incluso nell'installazione <profiles> predefinita di IIS 7.
Procedure
Come configurare la memorizzazione nella cache dell'output della pagina
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni passare alla connessione, al sito, all'applicazione o alla directory per cui si vuole configurare la memorizzazione nella cache dell'output della pagina.
Nel riquadro Home scorrere fino a Memorizzazione nella cache di output e quindi fare doppio clic su Memorizzazione nella cache di output.
Nel riquadro Azioni fare clic su Aggiungi...
Nella finestra di dialogo Aggiungi regola cache digitare l'estensione del nome file da memorizzare nella cache nella casella Estensione nome file e quindi selezionare l'opzione memorizzazione nella cache in modalità utente , l'opzione memorizzazione nella cache in modalità kernel o entrambi.
Selezionare le opzioni da usare per la memorizzazione nella cache e quindi fare clic su OK.
Configurazione
Attributi
| Attributo | Descrizione | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
duration |
Attributo timeSpan facoltativo. Specifica il tempo (in secondi) in cui viene memorizzato nella cache la pagina o il controllo utente Il valore predefinito è 00:00:30. |
||||||||||||||
extension |
Attributo stringa obbligatorio. Specifica l'estensione del nome file per i file che si desidera memorizzare nella cache. |
||||||||||||||
kernelCachePolicy |
Attributo enumerazione facoltativo. Configura i criteri di memorizzazione nella cache del kernel. L'attributo kernelCachePolicy può essere uno dei valori seguenti. Il valore predefinito è DontCache.
|
||||||||||||||
location |
Attributo enumerazione facoltativo. Specifica i valori validi per il controllo della posizione della risposta HTTP inserita nella cache di output per una risorsa. L'attributo location può essere uno dei valori possibili seguenti. Il valore predefinito è Server.
|
||||||||||||||
policy |
Attributo enumerazione facoltativo. Configura i criteri di memorizzazione nella cache dell'output. L'attributo dei criteri può essere uno dei valori possibili seguenti. Il valore predefinito è DontCache.
|
||||||||||||||
varyByHeaders |
Attributo stringa facoltativo. Specifica un elenco delimitato da punto e virgola di intestazioni HTTP usate per variare la cache di output. Quando questo attributo è impostato su più intestazioni, la cache di output contiene una versione diversa del documento richiesto per ogni combinazione di intestazioni specificate. |
||||||||||||||
varyByQueryString |
Attributo stringa facoltativo. Specifica un elenco delimitato da punto e virgola di stringhe utilizzate per variare la cache di output. Per impostazione predefinita, queste stringhe corrispondono a un valore della stringa di query inviato con attributi del metodo GET o a un parametro inviato tramite il metodo POST . Quando questo attributo è impostato su più parametri, la cache di output contiene una versione diversa del documento richiesto per ogni combinazione di parametri specificati. I valori possibili includono nessuno, un asterisco (*)e qualsiasi stringa di query valida o nome di parametro POST . |
Elementi figlio
Nessuno.
Esempio di configurazione
L'esempio di configurazione seguente abilita la memorizzazione nella cache in modalità utente e la memorizzazione nella cache in modalità kernel, entrambe abilitate per impostazione predefinita in IIS 7.0. Usa anche l'elemento <add> contenuto dall'elemento per abilitare la memorizzazione nella cache dell'output <profiles> per i file con estensione asp. Usa anche l'attributo dei criteri per memorizzare nella cache la pagina fino a quando non viene modificata; esegue la stessa operazione per la memorizzazione nella cache del kernel usando l'attributo kernelCachePolicy .
<configuration>
<system.webServer>
<caching enabled="true" enableKernelCache="true">
<profiles>
<add extension=".asp" policy="CacheUntilChange" kernelCachePolicy="CacheUntilChange" />
</profiles>
</caching>
</system.webServer>
</configuration>
L'esempio di codice seguente imposta la dimensione massima della cache di output su 1 gigabyte e imposta la dimensione massima di una risposta che può essere archiviata nella cache di output su 512 kilobyte.
<configuration>
<system.webServer>
<caching enabled="true" enableKernelCache="true" maxCacheSize="1000" maxResponseSize="512000"/>
</system.webServer>
</configuration>
Codice di esempio
Gli esempi seguenti configurano la memorizzazione nella cache dell'output della pagina per i file con estensione asp e configuraNO IIS per memorizzare nella cache in modalità utente e kernel fino a quando i file ASP non cambiano.
AppCmd.exe
appcmd.exe set config -section:system.webServer/caching /+"profiles.[extension='asp',policy='CacheUntilChange',kernelCachePolicy='CacheUntilChange']" /commit:apphost
Nota
È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. In questo modo le impostazioni di configurazione vengono confermate nella sezione relativa al percorso appropriato nel file ApplicationHost.config.
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 cachingSection = config.GetSection("system.webServer/caching");
ConfigurationElementCollection profilesCollection = cachingSection.GetCollection("profiles");
ConfigurationElement addElement = profilesCollection.CreateElement("add");
addElement["extension"] = @"asp";
addElement["policy"] = @"CacheUntilChange";
addElement["kernelCachePolicy"] = @"CacheUntilChange";
profilesCollection.AddAt(0, 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.GetApplicationHostConfiguration
Dim cachingSection As ConfigurationSection = config.GetSection("system.webServer/caching")
Dim profilesCollection As ConfigurationElementCollection = cachingSection.GetCollection("profiles")
Dim addElement As ConfigurationElement = profilesCollection.CreateElement("add")
addElement("extension") = "asp"
addElement("policy") = "CacheUntilChange"
addElement("kernelCachePolicy") = "CacheUntilChange"
profilesCollection.AddAt(0, addElement)
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var cachingSection = adminManager.GetAdminSection("system.webServer/caching", "MACHINE/WEBROOT/APPHOST");
var profilesCollection = cachingSection.ChildElements.Item("profiles").Collection;
var addElement = profilesCollection.CreateNewElement("add");
addElement.Properties.Item("extension").Value = "asp";
addElement.Properties.Item("policy").Value = "CacheUntilChange";
addElement.Properties.Item("kernelCachePolicy").Value = "CacheUntilChange";
profilesCollection.AddElement(addElement, 0);
adminManager.CommitChanges();
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set cachingSection = adminManager.GetAdminSection("system.webServer/caching", "MACHINE/WEBROOT/APPHOST")
Set profilesCollection = cachingSection.ChildElements.Item("profiles").Collection
Set addElement = profilesCollection.CreateNewElement("add")
addElement.Properties.Item("extension").Value = "asp"
addElement.Properties.Item("policy").Value = "CacheUntilChange"
addElement.Properties.Item("kernelCachePolicy").Value = "CacheUntilChange"
profilesCollection.AddElement addElement, 0
adminManager.CommitChanges()