HttpRequestCachePolicy Costruttori

Definizione

Spazio dei nomi:

System.Net.Cache

Assembly:

netstandard.dll, System.Net.Requests.dll

Inizializza una nuova istanza della classe HttpRequestCachePolicy.

Overload

Nome	Descrizione
HttpRequestCachePolicy()	Inizializza una nuova istanza della classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando la data di sincronizzazione della cache specificata.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando i criteri di cache specificati.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando i valori di data e ora specificati.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando l'età massima, il valore del controllo età e il valore di ora specificati.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando la data di validità massima, il valore del controllo dell'età, il valore dell'ora 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 della cache usando questo costruttore.

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 Level proprietà su Default.

HttpRequestCachePolicy(DateTime)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della HttpRequestCachePolicy classe 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 l'ora in cui le risorse archiviate nella cache devono essere riconvalidate.

Esempio

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

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 è necessario riconvalidare il contenuto memorizzato nella cache. 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 non valida la voce memorizzata nella cache, viene usata la voce dalla cache. Se la data di sincronizzazione della cache è impostata su una data futura, la voce viene riconvalidata ogni volta che viene richiesta, fino al termine della data di sincronizzazione della cache.

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

HttpRequestCachePolicy(HttpRequestCacheLevel)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della HttpRequestCachePolicy classe 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

Un HttpRequestCacheLevel valore.

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.

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

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

Commenti

Questo costruttore inizializza la Level proprietà 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 HttpRequestCachePolicy classe utilizzando i valori di data e ora specificati.

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 valori di enumerazione seguenti HttpCacheAgeControl : MaxAge, MaxStaleo MinFresh.

ageOrFreshOrStale

TimeSpan

Valore TimeSpan che specifica un periodo di tempo.

Eccezioni

ArgumentException

Il valore specificato per il cacheAgeControl parametro non può essere utilizzato con questo costruttore.

Esempio

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

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 usato 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 Level proprietà su Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando l'età massima, il valore del controllo età 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

Un HttpCacheAgeControl valore.

maxAge

TimeSpan

Valore TimeSpan che specifica la durata massima per le risorse.

freshOrStale

TimeSpan

Valore TimeSpan che specifica un periodo 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.

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 usato 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 Level proprietà su Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Origine:

HttpRequestCachePolicy.cs

Inizializza una nuova istanza della HttpRequestCachePolicy classe utilizzando la data di validità massima, il valore del controllo dell'età, il valore dell'ora 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

Un HttpCacheAgeControl valore.

maxAge

TimeSpan

Valore TimeSpan che specifica la durata massima per le risorse.

freshOrStale

TimeSpan

Valore TimeSpan che specifica un periodo di tempo.

cacheSyncDate

DateTime

Oggetto DateTime che specifica l'ora in cui le risorse archiviate nella cache devono essere riconvalidate.

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.

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