프로필 <캐싱 프로필>

아티클
07/19/2023

개요

<profiles> 요소의 <caching> 요소는 출력 캐싱에 사용할 프로필을 지정합니다.

호환성

버전	참고
IIS 10.0	`<profiles>` 요소가 IIS 10.0에서 수정되지 않았습니다.
IIS 8.5	`<profiles>` 요소가 IIS 8.5에서 수정되지 않았습니다.
IIS 8.0	`<profiles>` 요소가 IIS 8.0에서 수정되지 않았습니다.
IIS 7.5	`<profiles>` 요소가 IIS 7.5에서 수정되지 않았습니다.
IIS 7.0	`<profiles>` 요소의 `<caching>` 요소는 IIS 7.0에서 도입되었습니다.
IIS 6.0	해당 없음

설치 프로그램

<profiles> 요소의 <caching> 요소는 IIS 7의 기본 설치에 포함됩니다.

방법

페이지 출력 캐싱을 구성하는 방법

IIS(인터넷 정보 서비스) 관리자를 엽니다.
- Windows Server 2012 또는 Windows Server 2012 R2를 사용하는 경우:
  - 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
- Windows 8 또는 Windows 8.1 사용하는 경우:
  - Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
  - 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
- Windows Server 2008 또는 Windows Server 2008 R2를 사용하는 경우:
  - 작업 표시줄에서 시작을 클릭하고 관리 도구를 가리킨 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
- Windows Vista 또는 Windows 7을 사용하는 경우:
  - 작업 표시줄에서 시작을 클릭한 다음 제어판 클릭합니다.
  - 관리 도구를 두 번 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 페이지 출력 캐싱을 구성하려는 연결, 사이트, 애플리케이션 또는 디렉터리로 이동합니다.
홈 창에서 출력 캐싱으로 스크롤한 다음 출력 캐싱을 두 번 클릭합니다.
작업 창에서 추가...를 클릭합니다.
캐시 규칙 추가 대화 상자에서 파일 이름 확장명 상자에 캐시할 파일 이름 확장명을 입력한 다음 사용자 모드 캐싱 옵션, 커널 모드 캐싱 옵션 또는 둘 다를 선택합니다.
캐싱에 사용할 옵션을 선택한 다음 확인을 클릭합니다.

구성

특성

없음

자식 요소

요소	Description
`add`	선택적 요소입니다. 출력 캐싱 프로필의 컬렉션에 출력 캐싱 프로필을 추가합니다.
`clear`	선택적 요소입니다. 출력 캐싱 프로필 컬렉션에서 출력 캐싱 프로필에 대한 모든 참조를 제거합니다.
`remove`	선택적 요소입니다. 출력 캐싱 프로필 컬렉션에서 출력 캐싱 프로필에 대한 참조를 제거합니다.

구성 샘플

다음 구성 예제에서는 사용자 모드 캐싱 및 커널 모드 캐싱을 사용하도록 설정하며, 둘 다 IIS 7.0에서 기본적으로 사용하도록 설정됩니다. 또한 요소에 <add><profiles> 포함된 요소를 사용하여 .asp 파일 이름 확장명을 가진 파일에 대한 출력 캐싱을 사용하도록 설정합니다. 또한 정책 특성을 사용하여 변경될 때까지 페이지를 캐시합니다. kernelCachePolicy 특성을 사용하여 커널 캐싱에 대해 동일한 작업을 수행합니다.

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

다음 코드 예제에서는 최대 출력 캐시 크기를 1기가바이트로 설정하고 출력 캐시에 저장할 수 있는 응답의 최대 크기를 512KB로 설정합니다.

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

샘플 코드

다음 예제에서는 .asp 파일 이름 확장명을 가진 파일에 대한 페이지 출력 캐싱을 구성하고 ASP 파일이 변경될 때까지 사용자 모드 및 커널 모드에서 캐시하도록 IIS를 구성합니다.

AppCmd.exe

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

참고

AppCmd.exe 사용하여 이러한 설정을 구성할 때 커밋 매개 변수 apphost 를 로 설정해야 합니다. 그러면 구성 설정이 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()

다음을 통해 공유