CachingProfileElement 클래스
지정된 요청 확장에 대한 캐싱을 구성합니다.
구문
class CachingProfileElement : CollectionElement
메서드
이 클래스에는 메서드가 없습니다.
속성
다음 표에서는 클래스에 의해 노출되는 속성을 나열합니다 CachingProfileElement .
| 속성 | Description |
|---|---|
Duration |
응답이 캐시에 남아 있어야 하는 시간을 지정하는 읽기/쓰기 datetime 값입니다. 기본값은 30초입니다. 유효한 시간 범위는 0~365일입니다. |
Extension |
캐시 프로필을 사용할 요청의 확장을 지정하는 필수 고유 읽기/쓰기 string 값입니다. 확장은 "EXT" 또는 "*" 형식이어야 합니다. 여기서 EXT 는 확장입니다. 키 속성입니다. 참고: 겹치는 확장 항목은 허용되지 않습니다. 각 요청은 정확히 하나의 CachingProfileElement 개체에 매핑됩니다. "*"가 있는 항목이 있는 경우 더 구체적인 확장이 있는 다른 캐싱 프로필은 별표로 프로필을 재정의합니다. 프로필 항목의 순서는 중요하지 않습니다. |
KernelCachePolicy |
커널 캐싱 정책을 구성하는 읽기/쓰기 sint32 값입니다. 가능한 값은 설명 섹션의 뒷부분에 나와 있습니다. |
Location |
출력 캐시에 사용할 수 있는 위치를 지정하는 읽기/쓰기 sint32 값입니다. 가능한 값은 설명 섹션의 뒷부분에 나와 있습니다. |
Policy |
출력 캐싱 정책을 구성하는 읽기/쓰기 sint32 값입니다. 가능한 값은 설명 섹션의 뒷부분에 나와 있습니다. |
VaryByHeaders |
서버에서 URL에 대한 캐시된 응답을 다양하게 적용하는 데 사용할 헤더 이름의 쉼표로 구분된 목록을 포함하는 읽기/쓰기 string 값입니다. |
VaryByQueryString |
서버에서 URL에 대한 캐시된 응답을 다양하게 적용하는 데 사용할 쿼리 문자열 매개 변수 이름의 쉼표로 구분된 목록을 포함하는 읽기/쓰기 string 값입니다. |
를 서브클래싱합니다.
이 클래스에는 서브클래스가 없습니다.
설명
이 클래스는 <profiles> ApplicationHost.config 파일의 <system.webServer/caching> 섹션 아래에 있는 요소에 해당합니다. 이 클래스의 인스턴스는 CachingProfileSettings 클래스의 배열 속성에 포함 Profiles 됩니다.
다음 표에서는 속성에 사용할 수 있는 값을 나열합니다 KernelCachePolicy . 기본값은 0(DontCache)입니다.
| 값 | 키워드 | Description |
|---|---|---|
| 0 | DontCache |
응답은 커널에 캐시되지 않습니다. 그러나 출력 캐싱은 여전히 발생할 수 있습니다. 참고: 이 설정은 속성의 충돌하는 설정을 재정의 Location 합니다. |
| 1 | CacheUntilChange |
응답은 항목이 무효화되거나 속성에 지정된 비활성 기간 이후에 만료될 때까지 HTTP.SYS 캐시에 Duration 캐시됩니다. |
| 2 | CacheForTimePeriod |
응답은 중간에 항목이 무효화된 경우에도 속성에 지정된 Duration 시간 동안 캐시됩니다. |
| 3 | DisableCache |
캐시가 비활성화되어 캐싱이 발생하지 않습니다. |
다음 표에서는 속성에 사용할 수 있는 값을 나열합니다 Location . 기본값은 3(Server)입니다.
| 값 | 키워드 | Description |
|---|---|---|
| 0 | Any |
응답은 클라이언트, 웹 서버 또는 프록시 서버에서 캐시할 수 있습니다. |
| 1 | Client |
응답은 클라이언트에서만 캐시됩니다. |
| 2 | Downstream |
응답은 프록시 서버와 클라이언트에서 캐시되지만 웹 서버에서는 캐시되지 않습니다. |
| 3 | Server |
응답은 웹 서버에서만 캐시됩니다. |
| 4 | None |
응답은 어디에도 캐시되지 않습니다. |
| 5 | ServerAndClient |
응답은 웹 서버와 클라이언트 모두에서 캐시되지만 프록시 서버에는 캐시되지 않습니다. 참고: 서버가 개인 콘텐츠에 대해 다양한 동작을 하는 경우 이 설정을 사용하여 프록시 캐시의 여러 사용자 간에 콘텐츠를 공유하지 않도록 할 수 있습니다. |
다음 표에서는 속성에 사용할 수 있는 값을 나열합니다 Policy . 기본값은 0(DontCache)입니다.
| 값 | 키워드 | Description |
|---|---|---|
| 0 | DontCache |
응답은 출력 캐시에 배치되지 않습니다. 그러나 커널 캐싱은 여전히 발생할 수 있습니다. |
| 1 | CacheUntilChange |
응답은 항목이 무효화되거나 속성에 지정된 비활성 기간이 지나면 만료될 때까지 캐시됩니다 Duration . |
| 2 | CacheForTimePeriod |
응답은 중간에 항목이 무효화된 경우에도 속성에 지정된 Duration 시간 동안 캐시됩니다. |
| 3 | DisableCache |
캐시가 비활성화되어 캐싱이 발생하지 않습니다. |
예제
다음 예제에서는 기본 웹 사이트에 대한 모든 CachingProfileElement 개체를 표시합니다.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the caching section for the default Web site.
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "CachingSection", oSection
' Display the path and location.
Wscript.Echo "Path: " & oSection.Path
Wscript.Echo "Location: " & oSection.Location
Wscript.Echo
' Display all of the caching profiles for the default Web site.
For Each oCachingProfileElement In oSection.Profiles.Profiles
Wscript.Echo
WScript.Echo "[ " & oCachingProfileElement.Extension & _
" ] Caching Profile"
WScript.Echo "-----------------------------------"
WScript.Echo "Duration: " & oCachingProfileElement.Duration
WScript.Echo "KernelCachePolicy: " & _
CachePolicyText(oCachingProfileElement.KernelCachePolicy)
WScript.Echo "Location: " & _
LocationText(oCachingProfileElement.Location)
WScript.Echo "Policy: " & _
CachePolicyText(oCachingProfileElement.Policy)
WScript.Echo "VaryByHeaders: " & _
oCachingProfileElement.VaryByHeaders
WScript.Echo "VaryByQueryString: " & _
oCachingProfileElement.VaryByQueryString
WScript.Echo
Next
' Provide text for KernelCachePolicy and Policy enumeration values.
Function CachePolicyText(enumval)
Select Case enumval
Case 0
CachePolicyText="DontCache"
Case 1
CachePolicyText="CacheUntilChange"
Case 2
CachePolicyText="CacheForTimePeriod"
Case 3
CachePolicyText="DisableCache"
Case Else
CachePolicyText="Undefined enumeration value"
End Select
End Function
' Provide text for Location enumeration values.
Function LocationText(enumval)
Select Case enumval
Case 0
LocationText="Any"
Case 1
LocationText="Client"
Case 2
GetLocationText="Downstream"
Case 3
LocationText="Server"
Case 4
LocationText="None"
Case 5
LocationText="ServerAndClient"
Case Else
LocationText="Undefined enumeration value"
End Select
End Function
상속 계층 구조
CachingProfileElement
요구 사항
| 형식 | Description |
|---|---|
| 클라이언트 | - Windows Vista의 IIS 7.0 - Windows 7의 IIS 7.5 - Windows 8의 IIS 8.0 - WINDOWS 10 IIS 10.0 |
| 서버 | - Windows Server 2008의 IIS 7.0 - Windows Server 2008 R2의 IIS 7.5 - Windows Server 2012의 IIS 8.0 - Windows Server 2012 R2의 IIS 8.5 - WINDOWS SERVER 2016 IIS 10.0 |
| 제품 | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF 파일 | WebAdministration.mof |
참고 항목
AspCache 클래스
CachingProfileSettings 클래스
CachingSection 클래스
CollectionElement 클래스
HttpClientCache 클래스