웹 응용 프로그램 프로젝트 배포를 위한 Web.config 변환 구문

업데이트: 2011년 5월

Web.config 파일에는 주로 응용 프로그램이 실행되는 환경에 따라 달라져야 하는 설정이 포함됩니다. 예를 들어 Web.config 파일을 배포할 경우 데이터베이스 연결 문자열을 변경하거나 디버깅을 사용하지 않도록 설정해야 할 수도 있습니다. 웹 응용 프로그램 프로젝트의 경우 ASP.NET에서는 배포 시 Web.config 파일의 변경(변환) 프로세스를 자동화하는 도구를 제공합니다. 배포 대상 환경 각각에 대해 해당 환경의 원본 Web.config 파일과 배포된 Web.config 파일의 차이점만 지정하는 변환 파일을 만듭니다.

변환 파일은 Web.config 파일이 배포될 때 어떻게 변경되어야 하는지를 지정하는 XML 파일입니다. 변환 동작은 xdt 접두사에 매핑되는 XML-Document-Transform 네임스페이스에 정의된 XML 특성을 사용하여 지정합니다. XML-Document-Transform 네임스페이스는 Locator 및 Transform 특성을 정의합니다. Locator 특성은 특정한 방식으로 변경할 Web.config 요소 또는 요소 세트를 지정합니다. Transform 특성은 Locator 특성이 찾는 요소에 대해 수행할 작업을 지정합니다.

다음 예제에서는 연결 문자열을 변경하고 customErrors 요소를 대체하는 변환 파일의 내용을 보여 줍니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="https://schemas.microsoft.com/XML-Document-Transform">
  <connectionStrings>
    <add name="MyDB" 
      connectionString="value for the deployed Web.config file" 
      xdt:Transform="SetAttributes" xdt:Locator="Match(name)"/>
  </connectionStrings>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
      mode="RemoteOnly" xdt:Transform="Replace">
      <error statusCode="500" redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

변환 파일의 루트 요소는 이전 예제에 표시된 것처럼 여는 태그의 XML-Document-Transform 네임스페이스를 지정해야 합니다. Locator 및 Transform 요소는 배포된 Web.config 파일에서 재현되지 않습니다.

이 다음 단원에서는 변환 파일에서 사용할 구문에 대한 참조 정보를 제공합니다.

Locator 특성 구문

다음의 각 단원에서는 단일 Locator 특성의 구문을 설명합니다.

조건

현재 요소의 XPath 식에 추가되는 XPath 식을 지정합니다. 결합된 XPath 식과 일치하는 요소가 선택됩니다.

구문

Locator="Condition(XPath expression)"

예제

다음 예제에서는 name 특성 값이 oldname인 연결 문자열 요소 또는 값이 oldprovider인 providerName 특성을 선택하는 방법을 보여 줍니다. 배포된 Web.config 파일에서는 선택된 요소가 변환 파일에 지정된 요소로 대체됩니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add name="AWLT" connectionString="newstring"
       providerName="newprovider"
       xdt:Transform="Replace" 
       xdt:Locator="Condition(@name='oldname'
         or @providerName='oldprovider')" />
  </connectionStrings>
</configuration>

지정된 Condition 식의 결과로 배포 Web.config 파일에 적용되는 유효 XPath 식은 다음과 같습니다.

configuration/connectionStrings[@name='AWLT' or @providerName='System.Data.SqlClient']

이 식은 현재 요소(configuration/connectionStrings)에 대한 암시적 XPath 조건을 명시적으로 지정된 식과 결합한 결과입니다.

Match

지정된 특성에 대해 일치하는 값을 가진 요소를 선택합니다. 특성 이름을 여러 개 지정하면 지정된 모든 특성과 일치하는 요소만 선택됩니다.

구문

Locator="Match(comma-delimited list of one or more attribute names)"

예제

다음 예제에서는 배포 Web.config 파일에서 name 특성에 AWLT가 있는 연결 문자열 add 요소를 선택하는 방법을 보여 줍니다. 배포된 Web.config 파일에서는 선택된 요소가 변환 파일에 지정된 add 요소로 대체됩니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add name="AWLT" connectionString="newstring"
       providerName="newprovider"
       xdt:Transform="Replace" 
       xdt:Locator="Match(name)" />
  </connectionStrings>
</configuration>

XPath

배포 Web.config 파일에 적용되는 절대 XPath 식을 지정합니다. Condition과 달리 지정된 식은 현재 요소에 해당하는 암시적 XPath 식에 추가되지 않습니다.

구문

Locator="XPath(XPath expression)"

예제

다음 예제에서는 Condition 키워드에 대해 이전 예제에서 선택한 것과 동일한 요소를 선택하는 방법을 보여 줍니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add name="AWLT" connectionString="newstring"
       providerName="newprovider"
       xdt:Transform="Replace" 
       xdt:Locator="XPath(configuration/connectionStrings[@name='AWLT'
         or @providerName='System.Data.SqlClient'])" />
  </connectionStrings>
</configuration>

변환 특성 구문

다음의 각 단원에서는 단일 Transform 특성의 구문을 설명합니다.

Replace

선택된 요소를 변환 파일에 지정된 요소로 대체합니다. 둘 이상의 요소가 선택된 경우 첫 번째로 선택된 요소만 대체됩니다. Replace 키워드를 사용하는 방법에 대한 예제는 Locator 특성에 대한 예제를 참조하십시오.

구문

Transform="Replace"

Insert

변환 파일에 정의된 요소를 선택한 요소에 형제로 추가합니다. 새 요소는 컬렉션의 끝에 추가됩니다.

구문

Transform="Insert"

예제

다음 예제에서는 배포 Web.config 파일에서 모든 연결 문자열을 선택하는 방법을 보여 줍니다. 배포된 Web.config 파일에서 지정된 연결 문자열이 컬렉션의 끝에 추가됩니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add name="AWLT" connectionString="newstring"
       providerName="newprovider"
       xdt:Transform="Insert" />
  </connectionStrings>
</configuration>

InsertBefore

변환 XML에 정의된 요소를 지정된 XPath 식에서 선택하는 요소 바로 앞에 삽입합니다. XPath 식은 배포 Web.config 파일에 전체적으로 적용되므로 절대 식이어야 하며, 현재 요소의 암시적 XPath 식에만 추가되지 않습니다.

구문

Transform="InsertBefore(XPath expression)"

예제

다음 예제에서는 모든 사용자에 대한 액세스를 거부하고 관리자에게 액세스 권한을 부여하는 allow 요소를 자신 앞에 삽입하는 deny 요소를 선택하는 방법을 보여 줍니다.

<configuration xmlns:xdt="...">
  <authorization>
    <allow roles="Admins"
      xdt:Transform="InsertBefore(/configuration/system.web/authorization/deny[@users='*'])" />
  </authorization>
</configuration>

InsertAfter

변환 XML에 정의된 요소를 지정된 XPath 식에서 선택하는 요소 바로 뒤에 삽입합니다. XPath 식은 배포 Web.config 파일에 전체적으로 적용되므로 절대 식이어야 하며, 현재 요소의 암시적 XPath 식에 추가되지 않습니다.

구문

Transform="InsertAfter(XPath expression)"

예제

다음 예제에서는 관리자에게 액세스 권한을 부여하고 지정된 사용자에 대한 액세스를 거부하는 deny 요소를 자신 뒤에 삽입하는 allow요소를 선택하는 방법을 보여 줍니다.

<configuration xmlns:xdt="...">
  <authorization>
    <deny users="UserName"
      xdt:Transform="InsertAfter
        (/configuration/system.web/authorization/allow[@roles='Admins'])" />
  </authorization>
</configuration>

Remove

선택한 요소를 제거합니다. 요소를 여러 개 선택한 경우 첫 번째 요소를 제거합니다.

구문

Transform="Remove"

예제

다음 예제에서는 배포 Web.config 파일에서 모든 연결 문자열 add 요소를 선택하는 방법을 보여 줍니다. 배포된 Web.config 파일에서 첫 번째 연결 문자열 요소만 제거됩니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add xdt:Transform="Remove" />
  </connectionStrings>
</configuration>

RemoveAll

선택한 요소를 제거합니다.

구문

Transform="RemoveAll"

예제

다음 예제에서는 배포 Web.config 파일에서 모든 연결 문자열을 선택하는 방법을 보여 줍니다. 배포된 Web.config 파일에서 모든 요소가 제거됩니다.

<configuration xmlns:xdt="...">
  <connectionStrings>
    <add xdt:Transform="RemoveAll" />
  </connectionStrings>
</configuration>

RemoveAttributes

선택한 요소에서 지정된 특성을 제거합니다.

구문

Transform="RemoveAttributes(comma-delimited list of one or more attribute names)"

예제

다음 예제에서는 배포 Web.config 파일에서 모든 compilation 요소를 선택하는 방법을 보여 줍니다. 구성 파일에는 compilation 요소가 하나만 존재할 수 있으므로 Locator 특성을 지정할 필요가 없습니다. 배포된 Web.config 파일에서 debug 및 batch 특성이 compilation 요소에서 제거됩니다.

<configuration xmlns:xdt="...">
  <compilation 
    xdt:Transform="RemoveAttributes(debug,batch)">
  </compilation>
</configuration>

SetAttributes

선택한 요소에 대한 특성을 지정된 값으로 설정합니다. Replace 변환 특성은 모든 특성을 포함하여 전체 요소를 대체합니다. 반대로 SetAttributes 특성을 사용하면 요소를 그대로 두고 선택된 특성만 변경할 수 있습니다.

구문

Transform="SetAttributes(comma-delimited list of one or more attribute names)"

예제

다음 예제에서는 배포 Web.config 파일에서 모든 compilation 요소를 선택하는 방법을 보여 줍니다. 구성 파일에는 compilation 요소가 하나만 존재할 수 있으므로 Locator 특성을 지정할 필요가 없습니다. 배포된 Web.config 파일에서 compilation 요소의 batch 특성 값이 false로 설정됩니다.

<configuration xmlns:xdt="...">
  <compilation 
    batch="false"
    xdt:Transform="SetAttributes(batch)">
  </compilation>
</configuration>

Locator 특성 생략

Locator 특성은 선택적입니다. Locator 특성을 지정하지 않으면 변경될 요소가 Transform 특성이 지정되는 요소를 통해 암시적으로 지정됩니다. 다음 예제에서는 Locator 특성이 별도로 지정되어 있지 않기 때문에 전체 system.web 요소가 대체됩니다.

<?xml version="1.0"?>
<configuration xmlns:xdt="https://schemas.microsoft.com/XML-Document-Transform">
  <system.web xdt:Transform="Replace">
    <customErrors defaultRedirect="GenericError.htm"
      mode="RemoteOnly">
      <error statusCode="500" redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

개별 요소에서 Transform 및 Locator 특성 사용

Transform 특성을 Locator 요소와 동일한 요소에서 설정할 필요가 없습니다. 자식 요소를 사용할 요소를 선택하기 위해 부모 요소에서 Locator 요소를 지정할 수 있습니다. 그런 다음 변경 내용을 자식에 적용하도록 자식 요소에서 Transform 특성을 지정할 수 있습니다.

다음 예제에서는 Locator 특성을 사용하여 지정된 경로에 대한 location 요소를 선택하는 방법을 보여 줍니다. 선택한 location 요소의 자식 요소만 변환됩니다.

<configuration xmlns:xdt="...">
  <location path="C:\MySite\Admin" xdt:Locator="Match(path)"> 
    <system.web>
      <pages viewStateEncryptionMode="Always"
        xdt:Transform="SetAttributes(viewStateEncryptionMode)" />
    </system.web> 
  </location> 
</configuration>

Locator 특성은 지정했지만 동일한 요소 또는 자식 요소에서 Transform 특성을 지정하지 않은 경우에는 변경되지 않습니다.

참고

부모 요소의 Transform 특성은 Transform을 지정하지 않은 경우에도 자식 요소에 영향을 줄 수 있습니다.예를 들어 system.web 요소에 xdt:Transform="Replace" 특성을 삽입하면 system.web 요소의 모든 자식 요소가 변환 파일의 내용으로 대체됩니다.

참고 항목

개념

ASP.NET 웹 응용 프로그램 프로젝트 배포 개요

연습: 웹 배포 패키지를 사용하여 웹 응용 프로그램 프로젝트 배포(1/4부)

변경 기록

날짜	변경 내용	이유
2011년 5월	대체 변환의 작동 방식에 대한 설명을 수정했습니다.	고객 의견