HttpRequestCachePolicy Costruttori

Definizione

Spazio dei nomi:

System.Net.Cache

Assembly:

System.Net.Requests.dll

Inizializza una nuova istanza della classe HttpRequestCachePolicy.

Overload

HttpRequestCachePolicy()	Inizializza una nuova istanza della classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la data di sincronizzazione della cache specificata.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i criteri di cache specificati.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i valori specificati di ora e controllo della durata.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e il valore di ora specificati.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e la data di sincronizzazione della cache specificati.

HttpRequestCachePolicy()

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy ();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene illustrata l'impostazione dei criteri di cache usando questo costruttore.

static WebResponse^ GetResponseUsingCacheDefault( Uri^ uri )
{
   // Set  the default cache policy level for the "http:" scheme.
   RequestCachePolicy^ policy = gcnew RequestCachePolicy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );
   request->CachePolicy = policy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"Policy level is {0}.", policy->Level );
   Console::WriteLine( L"Is the response from the cache? {0}", response->IsFromCache );
   return response;
}

public static WebResponse GetResponseUsingCacheDefault(Uri uri)
{
    // Set  the default cache policy level for the "http:" scheme.
    RequestCachePolicy policy = new RequestCachePolicy();
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);

    return response;
}

Commenti

Questo costruttore inizializza la proprietà Level su Default.

HttpRequestCachePolicy(DateTime)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la data di sincronizzazione della cache specificata.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy (DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheSyncDate As DateTime)

Parametri

cacheSyncDate

DateTime

Oggetto DateTime che specifica a quale ora è necessario riconvalidare le risorse memorizzate nella cache.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di criteri di cache in base a una data di sincronizzazione della cache.

static HttpRequestCachePolicy^ CreateLastSyncPolicy( DateTime when )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( when );
   Console::WriteLine( L"When: {0}", when );
   Console::WriteLine( policy->CacheSyncDate );
   return policy;
}

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime when)
{
    HttpRequestCachePolicy policy =
       new HttpRequestCachePolicy(when);

    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy;
}

Commenti

La data di sincronizzazione della cache consente di specificare una data assoluta quando il contenuto memorizzato nella cache deve essere riconvalidato. Se la voce della cache è stata riconvalidata prima della data di sincronizzazione della cache, si verifica la riconvalida con il server. Se la voce della cache è stata riconvalidata dopo la data di sincronizzazione della cache e non sono previsti requisiti di riconvalida del server che rendono la voce memorizzata nella cache non valida, viene usata la voce dalla cache. Se la data di sincronizzazione della cache è impostata su una data futura, la voce viene riconvalidata a ogni richiesta fino al superamento della data di sincronizzazione della cache.

Questo costruttore inizializza la proprietà Level su Default. La proprietà CacheSyncDate viene inizializzata su cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i criteri di cache specificati.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpRequestCacheLevel level);

public HttpRequestCachePolicy (System.Net.Cache.HttpRequestCacheLevel level);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpRequestCacheLevel -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (level As HttpRequestCacheLevel)

Parametri

level

HttpRequestCacheLevel

Valore HttpRequestCacheLevel.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un criterio di cache che consente l'uso delle risorse presenti nella cache dalla cache.

static HttpRequestCachePolicy^ CreateCacheIfAvailablePolicy()
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::CacheIfAvailable );
   Console::WriteLine( policy );
   return policy;
}

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);

    Console.WriteLine(policy.ToString());
    return policy;
}

Commenti

Questo costruttore inizializza la proprietà Level su level.

Il HttpRequestCacheLevel valore controlla se la memorizzazione nella cache è abilitata e quando è possibile usare la cache. Per altre informazioni, vedere la HttpRequestCacheLevel documentazione.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i valori specificati di ora e controllo della durata.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, ageOrFreshOrStale As TimeSpan)

Parametri

cacheAgeControl

HttpCacheAgeControl

Uno dei seguenti valori dell'enumerazione HttpCacheAgeControl: MaxAge, MaxStale o MinFresh.

ageOrFreshOrStale

TimeSpan

Valore TimeSpan che specifica una quantità di tempo.

Eccezioni

ArgumentException

Non è possibile utilizzare con questo costruttore il valore specificato per il parametro cacheAgeControl.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di criteri di cache in base al livello minimo di aggiornamento.

static HttpRequestCachePolicy^ CreateMinFreshPolicy( TimeSpan span )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MinFresh,span );
   Console::WriteLine( L"Minimum freshness {0}", policy->MinFresh );
   return policy;
}

public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan span)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span);
    Console.WriteLine("Minimum freshness {0}", policy.MinFresh.ToString());
    return policy;
}

Commenti

Il cacheAgeControl valore definisce il significato del valore del ageOrFreshOrStale parametro e viene utilizzato per impostare la proprietà associata. Ad esempio, quando si specifica MaxStale, la MaxStale proprietà viene impostata sul valore del ageOrFreshOrStale parametro .

Questo costruttore inizializza la proprietà Level su Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e il valore di ora specificati.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan)

Parametri

cacheAgeControl

HttpCacheAgeControl

Valore HttpCacheAgeControl.

maxAge

TimeSpan

Valore TimeSpan che specifica la durata massima per le risorse.

freshOrStale

TimeSpan

Valore TimeSpan che specifica una quantità di tempo.

Eccezioni

ArgumentException

Il valore specificato per il parametro cacheAgeControl non è valido.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di criteri di cache in base alla validità minima e alla validità massima.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy( TimeSpan freshMinimum, TimeSpan ageMaximum )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh,
       ageMaximum, freshMinimum );
   Console::WriteLine( policy );
   return policy;
}

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum);
    Console.WriteLine(policy.ToString());
    return policy;
}

Commenti

Il cacheAgeControl valore viene utilizzato per interpretare il significato del valore del freshOrStale parametro e impostare la proprietà associata. Ad esempio, quando si specifica MaxStale, la MaxStale proprietà viene impostata sul valore del freshOrStale parametro . Quando si specifica MaxAgeAndMaxStale, la MaxAge proprietà viene impostata usando il valore del maxAge parametro e la MaxStale proprietà viene impostata usando il valore del freshOrStale parametro .

Si noti che, a meno che non si specifichi MaxAgeAndMaxStale o MaxAgeAndMinFresh, la MaxAge proprietà non è impostata.

Questo costruttore inizializza la proprietà Level su Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e la data di sincronizzazione della cache specificati.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

public HttpRequestCachePolicy (System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan * DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan, cacheSyncDate As DateTime)

Parametri

cacheAgeControl

HttpCacheAgeControl

Valore HttpCacheAgeControl.

maxAge

TimeSpan

Valore TimeSpan che specifica la durata massima per le risorse.

freshOrStale

TimeSpan

Valore TimeSpan che specifica una quantità di tempo.

cacheSyncDate

DateTime

Oggetto DateTime che specifica a quale ora è necessario riconvalidare le risorse memorizzate nella cache.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di criteri di cache in base alla validità minima, alla validità massima e alla data di sincronizzazione della cache.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy2( TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when )
{
   HttpRequestCachePolicy^ policy = 
       gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh, 
       ageMaximum, freshMinimum, when );
   Console::WriteLine( policy );
   return policy;
   
   // For the following invocation: CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0),         );
   // the output is:
   // Level:Automatic AgeControl:MinFreshAndMaxAge MinFresh:18000 MaxAge:36000
}

public static HttpRequestCachePolicy CreateFreshAndAgePolicy2(TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum, when);
    Console.WriteLine(policy.ToString());
    return policy;
    // For the following invocation:
    // CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0),);
    // the output is:
    // Level:Automatic
    // AgeControl:MinFreshAndMaxAge
    // MinFresh:18000
    // MaxAge:36000
}

Commenti

Il cacheAgeControl valore viene utilizzato per interpretare il significato del valore del freshOrStale parametro e impostare la proprietà associata. Ad esempio, quando si specifica MaxStale, la MaxStale proprietà viene impostata sul valore del freshOrStale parametro . Quando si specifica MaxAgeAndMaxStale, la MaxAge proprietà viene impostata usando il valore del maxAge parametro e la MaxStale proprietà viene impostata usando il valore del freshOrStale parametro .

Si noti che, a meno che non si specifichi MaxAgeAndMaxStale o MaxAgeAndMinFresh, la MaxAge proprietà non è impostata.

Questo costruttore inizializza la CacheSyncDate proprietà su cacheSyncDatee inizializza la Level proprietà su Default.