browserCaps에 대한 filter 요소(ASP.NET 설정 스키마)

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

이 요소는 특정 브라우저 정의에 개별 설정을 적용하는 데 사용할 수 있는 검색 문자열 목록을 지정합니다.

참고

Web.config 파일에 browserCaps 요소를 사용하여 브라우저를 정의하는 기능은 .NET Framework 버전 2.0에서 더 이상 사용되지는 않지만 계속 지원됩니다.이 요소의 데이터는 컴퓨터 수준의 %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers 폴더와 응용 프로그램 수준의 기존 App_Browsers 폴더에 있는 브라우저 정의 파일(.browser)의 정보와 병합됩니다.자세한 내용은 브라우저 정의 파일 스키마(browsers 요소)를 참조하십시오.

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
match	선택적 String 특성입니다. with 특성에 대해 테스트되는 .NET Framework 정규식을 지정합니다. 이 특성을 생략하면 일치 항목 검색이 성공적으로 수행된 것으로 간주됩니다.
with	선택적 String 특성입니다. 검색할 .NET Framework 정규식 또는 문자열을 지정합니다. 이 특성을 생략하면 use 요소에 지정된 문자열이 사용됩니다.

match

선택적 String 특성입니다.

with 특성에 대해 테스트되는 .NET Framework 정규식을 지정합니다. 이 특성을 생략하면 일치 항목 검색이 성공적으로 수행된 것으로 간주됩니다.

with

선택적 String 특성입니다.

검색할 .NET Framework 정규식 또는 문자열을 지정합니다. 이 특성을 생략하면 use 요소에 지정된 문자열이 사용됩니다.

자식 요소

요소	설명
case	지정된 여러 항목 중에서 처음으로 일치 항목이 발견된 다음에 패턴 일치가 중지되도록 합니다.

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.
browserCaps	지원되는 브라우저 및 해당 브라우저의 기능에 대한 설정을 지정합니다. 필요에 따라 browserCaps 요소를 업데이트하여 새 브라우저와 기능을 지정할 수 있습니다. 유효한 브라우저 속성 목록을 보려면 HttpBrowserCapabilities를 참조하십시오.

configuration

공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.

system.web

구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.

browserCaps

지원되는 브라우저 및 해당 브라우저의 기능에 대한 설정을 지정합니다. 필요에 따라 browserCaps 요소를 업데이트하여 새 브라우저와 기능을 지정할 수 있습니다.

유효한 브라우저 속성 목록을 보려면 HttpBrowserCapabilities를 참조하십시오.

설명

browserCaps 요소는 특정 브라우저 정의에 개별 설정을 적용하는 데 사용할 수 있는 검색 문자열 목록을 지정합니다. 목록에 포함된 규칙은 순서대로 적용됩니다. 일치하는 첫 번째 자식 case 요소가 평가되고 나머지 자식 case 요소는 무시됩니다.

기본 구성

.NET Framework 버전 2.0에서는 지원되는 브라우저 및 해당 브라우저의 기능을 지정하기 위해 browserCaps 요소 대신 브라우저 정의 파일을 사용하므로 filter 요소가 구성되어 있지 않습니다. 자세한 내용은 브라우저 정의 파일 스키마(browsers 요소)를 참조하십시오.

.NET Framework 버전 1.0 및 1.1에서 Machine.config 파일에 구성된 기본 filter 요소는 너무 많아서 여기에 모두 나열할 수 없습니다. 브라우저 데이터를 업데이트하려면 http://www.cyscape.com/browsercaps 사이트로 이동하십시오. 정기적 장치 업데이트로 이 브라우저 기능 섹션이 대체됩니다.

예제

다음 코드 예제에서는 모든 버전의 Microsoft Internet Explorer에 대해 User-Agent HTTP 헤더를 구문 분석하는 방법을 보여 줍니다. 이때 User-Agent 문자열의 형식이 거의 변경되지 않아야 합니다.

이 예제에서는 .NET Framework 정규식을 사용하고, 버전 번호를 User-Agent 문자열에서 browserCaps 요소로 직접 이동하기 위해 부분식을 캡처하는 정규식 기능을 활용합니다.

이 파일에서는 Microsoft IIS(인터넷 정보 서비스)의 browscap.ini 파일과 비슷한 대입문 형식으로 이름/값 쌍을 지정합니다. 예를 들어 "browser=IE" 줄은 브라우저 필드의 값을 문자열 "IE"로 설정합니다.

<configuration>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
         <case match="^Mozilla[^(]*\(compatible; MSIE 
            (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
            (?'extra'.*)">
            browser=IE
            version=${ver}
            majorver=${major}
            minorver=${minor}
            <case match="^2\." with="%{version}">
               tables=true
               cookies=true
               backgroundsounds=true
               <case match="2\.5b" with="%{version}">
                  beta=true
               </case>
            </case>
         </case>
      </filter>
   </browsercaps>
</configuration>

요소 정보

구성 섹션 처리기	HttpCapabilitiesSectionHandler
구성 멤버	Browsers
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0(사용되지 않음), 1.0 또는 1.1 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목

Share via