HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metode

Referensi

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Memungkinkan penyisipan blok substitusi respons ke dalam respons, yang memungkinkan pembuatan dinamis wilayah respons tertentu untuk respons cache output.

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);

public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);

member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit

Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

Parameter

callback: HttpResponseSubstitutionCallback

Metode, kontrol pengguna, atau objek untuk diganti.

Pengecualian

ArgumentException

Target callback parameter berjenis Control.

Keterangan

Anda dapat menggunakan WriteSubstitution metode untuk substitusi pasca-cache di halaman yang di-cache output Anda. Dengan meneruskan HttpContext objek ke metode panggilan balik dengan tanda tangan yang ditentukan HttpResponseSubstitutionCallback , Anda dapat mengganti konten yang di-cache output di lokasi tertentu di cache halaman. Untuk memulai penggantian, panggil WriteSubstitution metode , berikan metode panggilan balik, yang harus aman untuk utas dan dapat berupa salah satu hal berikut:

Metode statis pada halaman kontainer atau kontrol pengguna.
Metode statis atau instans pada objek arbitrer lain.

Pada permintaan pertama ke halaman, WriteSubstitution memanggil HttpResponseSubstitutionCallback delegasi untuk menghasilkan output. Kemudian, ia menambahkan buffer substitusi ke respons, yang mempertahankan delegasi untuk memanggil permintaan di masa mendatang. Terakhir, ini menurunkan cacheabilitas sisi klien dari publik ke khusus server, memastikan permintaan di masa mendatang ke halaman memanggil kembali delegasi dengan tidak melakukan penembolokan pada klien.

Catatan

Substitusi pasca-cache tidak didukung untuk kontrol pengguna yang di-cache di mana penembolokan output diterapkan pada tingkat kontrol pengguna. Ini juga dikenal sebagai penembolokan fragmen. Untuk informasi selengkapnya, lihat Bagian Penembolokan halaman ASP.NET.

Berlaku untuk

Bagikan melalui