WebRequest.CachePolicy Tulajdonság

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.Requests.dll

Forrás:

WebRequest.cs

Lekéri vagy beállítja a kérés gyorsítótárszabályzatát.

public:
 virtual property System::Net::Cache::RequestCachePolicy ^ CachePolicy { System::Net::Cache::RequestCachePolicy ^ get(); void set(System::Net::Cache::RequestCachePolicy ^ value); };

public virtual System.Net.Cache.RequestCachePolicy? CachePolicy { get; set; }

member this.CachePolicy : System.Net.Cache.RequestCachePolicy with get, set

Public Overridable Property CachePolicy As RequestCachePolicy

Tulajdonság értéke

RequestCachePolicy

Gyorsítótárszabályzatot RequestCachePolicy meghatározó objektum.

Példák

Az alábbi példakód bemutatja, hogy a gyorsítótár-szabályzatot egy webes kéréshez kell beállítani.

// The following method demonstrates overriding the
// caching policy for a request.
public static WebResponse GetResponseNoCache(Uri uri)
{
    // Set a default policy level for the "http:" and "https" schemes.
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
    HttpWebRequest.DefaultCachePolicy = policy;
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    // Define a cache policy for this request only.
    HttpRequestCachePolicy noCachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.NoCacheNoStore);
    request.CachePolicy = noCachePolicy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("IsFromCache? {0}", response.IsFromCache);
    return response;
}

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Az aktuális gyorsítótárszabályzat és a kért erőforrás jelenléte a gyorsítótárban határozza meg, hogy lekérhető-e válasz a gyorsítótárból. A gyorsítótárazott válaszok használata általában javítja az alkalmazás teljesítményét, de fennáll annak a kockázata, hogy a gyorsítótárban lévő válasz nem egyezik a kiszolgáló válaszával.

Az alapértelmezett gyorsítótárszabályzat a Machine.config konfigurációs fájlban vagy a DefaultCachePolicy Hypertext Transfer Protocol (HTTP) vagy a Secure Hypertext Transfer Protocol (HTTPS) URI-sémát használó kérelmek tulajdonságának beállításával adható meg.

Az erőforrás másolata csak akkor lesz hozzáadva a gyorsítótárhoz, ha az erőforrás válaszfolyamát lekéri és beolvassa a stream végéig. Így ugyanahhoz az erőforráshoz egy másik kérés is használhat gyorsítótárazott másolatot a kérés gyorsítótárszabályzatának szintjétől függően.

Lásd még

• RequestCachePolicy
• HttpRequestCacheLevel
• RequestCacheLevel
• DefaultCachePolicy
• DefaultCachePolicy