Bagikan melalui

HttpCacheVaryByContentEncodings Kelas

Definisi

Ruang nama:
System.Web
Rakitan:
System.Web.dll

Menyediakan cara yang aman untuk mengatur VaryByContentEncodings properti HttpCachePolicy kelas.

public ref class HttpCacheVaryByContentEncodings sealed
public sealed class HttpCacheVaryByContentEncodings
type HttpCacheVaryByContentEncodings = class
Public NotInheritable Class HttpCacheVaryByContentEncodings
Warisan
Object
HttpCacheVaryByContentEncodings

Contoh

Contoh berikut menunjukkan cara mengaktifkan respons terkompresi dinamis yang dapat dilayani dari cache output. Pengodean yang dapat diterima adalah "gzip" dan diatur dengan menggunakan VaryByContentEncodings atribut @ OutputCache direktif. Jika server Web yang menghosting halaman tidak mengaktifkan pemadatan dinamis, cache output tidak akan memiliki respons cache untuk pengodean konten yang ditentukan.

<%@ Page Language="C#" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Varying Output Cache By Content Encoding</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <%= DateTime.Now.ToString() %>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Varying Output Cache By Content Encoding</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <%= DateTime.Now.ToString() %>
    </div>
    </form>
</body>
</html>

Keterangan

Properti VaryByContentEncodings digunakan untuk menentukan apakah respons yang dikompresi secara dinamis di-cache. Penembolokan respons yang dikompresi secara dinamis berarti bahwa biaya pemadatan hanya dikeluarkan satu kali, selama permintaan pertama untuk sumber daya (atau setelah aplikasi dimulai ulang) dan ketika item cache kedaluwarsa.

Properti VaryByContentEncodingsHttpCachePolicy kelas mengidentifikasi parameter header permintaan mana yang ASP.NET gunakan untuk mengidentifikasi variasi respons secara unik jika ada beberapa respons cache untuk sumber daya. Ini berguna ketika respons bergantung pada sekumpulan input klien, seperti header, parameter, atau pengodean konten.

Kelas HttpCacheVaryByContentEncodings tidak terkait langsung dengan header kontrol cache HTTP. Namun, ini membantu memastikan bahwa respons terhadap klien atau proksi bervariasi menurut pengodean konten yang ditentukan. Mengatur cache agar bervariasi menurut pengodean konten memungkinkan ASP.NET untuk memvariasikan respons menurut Accept-Encoding header. Ketika permintaan diproses, Accept-Encoding header dicentang dan pengodean pertama yang dapat diterima diidentifikasi dan digunakan untuk mengambil salah satu tindakan berikut:

  • Jika pengodean yang cocok juga ditemukan dalam VaryByContentEncodings daftar dan respons cache ada, respons yang di-cache akan dikirim.

  • Jika pengodean yang cocok juga ditemukan dalam VaryByContentEncodings daftar tetapi respons yang di-cache tidak ada, respons dihasilkan dan dimasukkan ke dalam cache.

  • Jika pengodean yang cocok tidak ditemukan dalam VaryByContentEncodings daftar, cache dicari untuk respons yang tidak dikodekan, juga disebut sebagai respons identitas. Jika respons identitas ditemukan, respons identitas akan dikirim. Jika tidak, respons baru yang tidak dikodekan dihasilkan dan disimpan dalam cache.

Untuk informasi selengkapnya tentang VaryByContentEncodings properti, lihat RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, tersedia di situs Web World Wide Web Consortium (W3C). Lihat bagian 14, "Definisi Bidang Header", untuk detail lengkapnya.

Anda dapat mengatur VaryByContentEncodings properti dengan menggunakan direktif @ OutputCache atau dengan menambahkan profil ke outputCacheProfile elemen dalam file Web.config.

Konstruktor

Nama Deskripsi
HttpCacheVaryByContentEncodings()

Menginisialisasi instans baru dari kelas HttpCacheVaryByContentEncodings.

Properti

Nama Deskripsi
Item[String]

Mendapatkan atau menetapkan nilai yang menunjukkan apakah cache bervariasi sesuai dengan pengodean konten yang ditentukan.

Metode

Nama Deskripsi
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetContentEncodings()

Mendapatkan array nilai yang menentukan pengodean konten yang akan digunakan untuk memvariasikan cache.
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
SetContentEncodings(String[])

Mengatur array nilai yang menentukan pengodean konten yang akan digunakan untuk bervariasi cache.
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga