Menambahkan Profil <Penembolokan ditambahkan>

Gambaran Umum

Elemen <add><profiles> elemen menambahkan profil penembolokan output ke kumpulan profil penembolokan output.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen `<add>` tidak dimodifikasi dalam IIS 10.0.
IIS 8.5	Elemen `<add>` tidak dimodifikasi dalam IIS 8.5.
IIS 8.0	Elemen `<add>` tidak dimodifikasi dalam IIS 8.0.
IIS 7.5	Elemen `<add>` tidak dimodifikasi dalam IIS 7.5.
IIS 7.0	Elemen `<add><profiles>` elemen diperkenalkan di IIS 7.0.
IIS 6.0	T/A

Siapkan

Elemen <add><profiles> elemen disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Cara mengonfigurasi penembolokan output halaman

Buka Pengelola Layanan Informasi Internet (IIS):
- Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:
  - Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).
- Jika Anda menggunakan Windows 8 atau Windows 8.1:
  - Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
  - Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).
- Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:
  - Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).
- Jika Anda menggunakan Windows Vista atau Windows 7:
  - Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
  - Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).
Di panel Koneksi , buka koneksi, situs, aplikasi, atau direktori yang ingin Anda konfigurasi penembolokan output halamannya.
Di panel Beranda , gulir ke Penembolokan Output, lalu klik dua kali Penembolokan Output.
Di panel Tindakan , klik Tambahkan...
Dalam kotak dialog Tambahkan Aturan Singgahan , ketik ekstensi nama file yang ingin Anda cache dalam kotak Ekstensi nama file , lalu pilih opsi Penembolokan mode pengguna , opsi penembolokan mode Kernel , atau keduanya.
Pilih opsi yang ingin Anda gunakan untuk penembolokan, lalu klik OK.

Konfigurasi

Atribut

Atribut Deskripsi

duration Atribut timeSpan opsional.

Menentukan waktu (dalam detik) bahwa halaman atau kontrol pengguna di-cache

Default adalah 00:00:30.

extension Atribut string yang diperlukan.

Menentukan ekstensi nama file untuk file yang ingin Anda cache.

kernelCachePolicy

Atribut enum opsional.

Mengonfigurasi kebijakan penembolokan kernel.

Atribut kernelCachePolicy bisa menjadi salah satu nilai berikut. Default adalah DontCache.

Nilai	Deskripsi
`DontCache`	Konten tidak di-cache. Nilai numerik adalah `0`.
`CacheUntilChange`	Konten hanya di-cache hingga konten berubah. Nilai numerik adalah `1`.
`CacheForTimePeriod`	Konten di-cache selama jangka waktu yang ditentukan oleh atribut durasi. Nilai numerik adalah `2`.
`DisableCache`	Cache dinonaktifkan dan tidak ada penembolokan yang akan terjadi. Nilai numerik adalah `3`.

location

Atribut enum opsional.

Menentukan nilai yang valid untuk mengontrol lokasi respons HTTP yang di-cache output untuk sumber daya.

Atribut lokasi dapat menjadi salah satu dari kemungkinan nilai berikut. Default adalah Server.

Nilai	Deskripsi
`Any`	Cache output dapat ditemukan di klien browser (tempat permintaan berasal), di server proksi (atau server lain) yang berpartisipasi dalam permintaan, atau di server tempat permintaan diproses. Nilai numerik adalah `0`.
`Client`	Cache output terletak di klien browser tempat permintaan berasal. Nilai numerik adalah `1`.
`Downstream`	Cache output dapat disimpan di perangkat berkemampukan cache HTTP 1.1 selain server asal. Ini termasuk server proksi dan klien yang membuat permintaan. Nilai numerik adalah `2`.
`Server`	Cache output terletak di server Web tempat permintaan diproses. Nilai numerik adalah `3`.
`None`	Cache output dinonaktifkan untuk halaman yang diminta. Nilai numerik adalah `4`.
`ServerAndClient`	Cache output hanya dapat disimpan di server asal atau di klien yang meminta. Server proksi tidak diizinkan untuk menyimpan respons. Nilai numerik adalah `5`.

policy

Atribut enum opsional.

Mengonfigurasi kebijakan penembolokan output.

Atribut kebijakan dapat menjadi salah satu dari kemungkinan nilai berikut. Default adalah DontCache.

Nilai	Deskripsi
`DontCache`	Konten tidak di-cache. Nilai numerik adalah `0`.
`CacheUntilChange`	Konten hanya di-cache hingga konten berubah. Nilai numerik adalah `1`.
`CacheForTimePeriod`	Konten di-cache selama jangka waktu yang ditentukan oleh atribut durasi. Nilai numerik adalah `2`.
`DisableCache`	Cache dinonaktifkan dan tidak ada penembolokan yang akan terjadi. Nilai numerik adalah `3`.

varyByHeaders Atribut string opsional.

Menentukan daftar header HTTP yang dipisahkan titik koma yang digunakan untuk memvariasikan cache output. Ketika atribut ini diatur ke beberapa header, cache output berisi versi berbeda dari dokumen yang diminta untuk setiap kombinasi header yang ditentukan.

varyByQueryString Atribut string opsional.

Menentukan daftar string yang dipisahkan titik koma yang digunakan untuk memvariasikan cache output. Secara default, string ini sesuai dengan nilai string kueri yang dikirim dengan atribut metode GET , atau parameter yang dikirim dengan menggunakan metode POST . Ketika atribut ini diatur ke beberapa parameter, cache output berisi versi berbeda dari dokumen yang diminta untuk setiap kombinasi parameter yang ditentukan. Nilai yang mungkin termasuk tidak ada, tanda bintang (*), dan string kueri atau nama parameter POST yang valid.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Contoh konfigurasi berikut memungkinkan penembolokan mode pengguna dan penembolokan mode kernel, yang keduanya diaktifkan secara default di IIS 7.0. Ini juga menggunakan elemen yang <add> dimuat oleh <profiles> elemen untuk mengaktifkan penembolokan output untuk file dengan ekstensi nama file .asp. Ini juga menggunakan atribut kebijakan untuk menghasilkan cache halaman sampai berubah; ini melakukan hal yang sama untuk penembolokan kernel menggunakan atribut kernelCachePolicy .

<configuration>
   <system.webServer>
      <caching enabled="true" enableKernelCache="true">
         <profiles>
            <add extension=".asp" policy="CacheUntilChange" kernelCachePolicy="CacheUntilChange" />
         </profiles>
      </caching>
   </system.webServer>
</configuration>

Contoh kode berikut mengatur ukuran cache output maksimum menjadi 1 gigabyte dan mengatur ukuran maksimum respons yang dapat disimpan dalam cache output menjadi 512 kilobyte.

<configuration>
   <system.webServer>
      <caching enabled="true" enableKernelCache="true" maxCacheSize="1000" maxResponseSize="512000"/>
   </system.webServer>
</configuration>

Kode Sampel

Contoh berikut mengonfigurasi penembolokan output halaman untuk file dengan ekstensi nama file .asp, dan mengonfigurasi IIS untuk cache dalam mode pengguna dan mode kernel hingga file ASP berubah.

AppCmd.exe

appcmd.exe set config -section:system.webServer/caching /+"profiles.[extension='asp',policy='CacheUntilChange',kernelCachePolicy='CacheUntilChange']" /commit:apphost

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample {
   private static void Main() {
      using(ServerManager serverManager = new ServerManager()) { 
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection cachingSection = config.GetSection("system.webServer/caching");
         ConfigurationElementCollection profilesCollection = cachingSection.GetCollection("profiles");

         ConfigurationElement addElement = profilesCollection.CreateElement("add");
         addElement["extension"] = @"asp";
         addElement["policy"] = @"CacheUntilChange";
         addElement["kernelCachePolicy"] = @"CacheUntilChange";
         profilesCollection.AddAt(0, addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim cachingSection As ConfigurationSection = config.GetSection("system.webServer/caching")
      Dim profilesCollection As ConfigurationElementCollection = cachingSection.GetCollection("profiles")
      Dim addElement As ConfigurationElement = profilesCollection.CreateElement("add")
      addElement("extension") = "asp"
      addElement("policy") = "CacheUntilChange"
      addElement("kernelCachePolicy") = "CacheUntilChange"
      profilesCollection.AddAt(0, addElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var cachingSection = adminManager.GetAdminSection("system.webServer/caching", "MACHINE/WEBROOT/APPHOST");
var profilesCollection = cachingSection.ChildElements.Item("profiles").Collection;

var addElement = profilesCollection.CreateNewElement("add");
addElement.Properties.Item("extension").Value = "asp";
addElement.Properties.Item("policy").Value = "CacheUntilChange";
addElement.Properties.Item("kernelCachePolicy").Value = "CacheUntilChange";
profilesCollection.AddElement(addElement, 0);

adminManager.CommitChanges();

Vbscript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set cachingSection = adminManager.GetAdminSection("system.webServer/caching", "MACHINE/WEBROOT/APPHOST")
Set profilesCollection = cachingSection.ChildElements.Item("profiles").Collection

Set addElement = profilesCollection.CreateNewElement("add")
addElement.Properties.Item("extension").Value = "asp"
addElement.Properties.Item("policy").Value = "CacheUntilChange"
addElement.Properties.Item("kernelCachePolicy").Value = "CacheUntilChange"
profilesCollection.AddElement addElement, 0

adminManager.CommitChanges()

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2023-07-19