Classe HttpCachePolicySettings

Articolo
07/18/2023

Rappresenta i criteri di cache HTTP predefiniti per le risorse di rete.

Sintassi

class HttpCachePolicySettings : EmbeddedObject

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla HttpCachePolicySettings classe .

Nome	Descrizione
`MaximumAge`	Valore di lettura/scrittura `datetime` che specifica la durata massima consentita per una risorsa restituita dalla cache. Il valore predefinito è infinite. Se la copia memorizzata nella cache della risorsa è precedente al valore di ora specificato, la risorsa deve essere riconvalidata confrontando la risorsa memorizzata nella cache con la risorsa nel server.
`MaximumStale`	Valore di lettura/scrittura `datetime` che specifica la quantità di tempo che la copia memorizzata nella cache della risorsa può essere usata dopo la scadenza del contenuto. Il valore predefinito è 0.
`MinimumFresh`	Valore di lettura/scrittura `datetime` che specifica il tempo di utilizzo della copia memorizzata nella cache della risorsa prima della scadenza del contenuto. Il valore predefinito è 0.
`PolicyLevel`	Valore di lettura/scrittura `sint32` che specifica il comportamento di memorizzazione nella cache HTTP per il computer locale. I valori possibili sono elencati più avanti nella sezione Osservazioni.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella DefaultHttpCachePolicy proprietà della classe RequestCachingSection .

Nella tabella seguente sono elencati i valori possibili per la PolicyLevel proprietà . Il valore predefinito è 0 (Default).

Valore	Parola chiave	Descrizione
0	`Default`	Soddisfa una richiesta di una risorsa utilizzando la copia della risorsa nella cache o inviando una richiesta della risorsa al server. L'azione eseguita è determinata dai criteri di cache correnti e dalla durata del contenuto nella cache. Questo è il livello di cache che la maggior parte delle applicazioni deve usare.
1	`BypassCache`	Soddisfa una richiesta utilizzando il server. Nessuna voce viene tratta dalle cache, aggiunta alle cache o rimossa dalle cache tra il client e il server. Si tratta del comportamento predefinito della cache specificato nel file di configurazione del computer incluso in .NET Framework.
2	`CacheOnly`	Soddisfa una richiesta usando la risorsa memorizzata nella cache locale; non invia una richiesta per un elemento che non si trova nella cache. Quando viene specificato questo livello di criteri di cache, viene generata un'eccezione WebException se l'elemento non si trova nella cache del client.
3	`CacheIfAvailable`	Soddisfa una richiesta di una risorsa dalla cache se la risorsa è disponibile nella cache; in caso contrario, invia una richiesta per una risorsa al server. Se l'elemento richiesto non è disponibile nella cache locale, ma è disponibile in una cache tra il client e il server, la cache intermedia soddisfa la richiesta.
4	`Revalidate`	Soddisfa una richiesta utilizzando la copia memorizzata nella cache della risorsa se il timestamp corrisponde al timestamp della risorsa nel server; in caso contrario, la risorsa viene scaricata dal server, presentata al chiamante e archiviata nella cache.
5	`Reload`	Soddisfa una richiesta utilizzando il server. La risposta potrebbe essere salvata nella cache, a seconda delle impostazioni della direttiva di controllo della `no-cache` cache e dell'intestazione `Pragma: no-cache` nel protocollo di memorizzazione nella cache HTTP.
6	`NoCacheNoStore`	Non soddisfa mai una richiesta usando le risorse dalla cache e non memorizza nella cache le risorse. Se la risorsa è presente nella cache locale, viene rimossa. Questo livello dei criteri indica alle cache intermedie di rimuovere la risorsa. Nel protocollo di memorizzazione nella cache HTTP questo risultato viene ottenuto usando la direttiva di controllo della `no-cache` cache.
7	`CacheOrNextCacheOnly`	Soddisfa una richiesta di una risorsa dalla cache del computer locale o da una cache remota nella rete locale. Se non possibile soddisfare la richiesta, viene generata un'eccezione `WebException`. Nel protocollo di memorizzazione nella cache HTTP questo risultato viene ottenuto usando la direttiva di controllo della `only-if-cached` cache.
8	`Refresh`	Soddisfa una richiesta utilizzando il server o una cache diversa da quella locale. Prima che una cache intermedia possa soddisfare la richiesta, tale cache deve riconvalidare la voce memorizzata nella cache con il server. Nel protocollo di memorizzazione nella cache HTTP, questa operazione viene ottenuta usando la direttiva di controllo della `max-age = 0` cache e l'intestazione Pragma:``no-cache .

Esempio

Nell'esempio di codice seguente vengono specificati i criteri di memorizzazione nella cache HTTP e vengono impostati i valori per le MinimumFreshproprietà , MaximumStalee MaximumAge .

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the RequestCachingSection.  
Set oSection = oWebAdmin.Get("RequestCachingSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the initial values for the DefaultHttpCachePolicy property.  
Call DisplayValues("Initial Values", oSection.DefaultHttpCachePolicy)  
  
' Set the http cache policy to use the default.  
oSection.DefaultHttpCachePolicy.PolicyLevel = 0  
  
' Set the MinimumFresh property to 30 minutes.  
oSection.DefaultHttpCachePolicy.MinimumFresh = "00000000003000.000000:000"  
  
' Set the MaximumStale property to 10 minutes.  
oSection.DefaultHttpCachePolicy.MaximumStale = "00000000001000.000000:000"  
  
' Set the MaximumAge property to 1 hour.  
oSection.DefaultHttpCachePolicy.MaximumAge =   "00000000010000.000000:000"  
  
' Save the values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with the new values.  
oSection.Refresh_  
  
' Show the changed values.  
Call DisplayValues("New Values", oSection.DefaultHttpCachePolicy)  
  
' ==== DisplayValues helper function. ====  
Function DisplayValues(HeadingText, oObject)  
    WScript.Echo  
    WScript.Echo String(Len(HeadingText), "=")  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "=")  
  
    For Each Prop In oObject.Properties_  
        WScript.Echo Prop.Name & ": " & Prop.Value  
    Next  
End Function

Gerarchia di ereditarietà

EmbeddedObject

HttpCachePolicySettings

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedere anche

Classe EmbeddedObject
Classe FtpCachePolicySettings
Classe RequestCachingSection
CIM_DATETIME

Condividi tramite