View source for Web Config Transform

[[Category:ASP.NET]]
[[Category:MVC]]
[[Category:CSharp]]

== Summary ==
 
<pre class="brush:xml">
<?xml version="1.0"?>
<configuration '''xmlns:xdt="http://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>
</pre>

== Locator Attribute Syntax ==
=== Condition ===
 Locator="Condition(XPath expression)"

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

The effective XPath expression that is applied to the development Web.config file as a result of the specified Condition expression is the following:

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

This expression is a result of combining the implicit XPath condition for the current element (configuration/connectionStrings) with the expression that is specified explicitly.

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

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

=== XPath ===
 Locator="XPath(XPath expression)"

<pre class="brush:xml">
<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>
</pre>

== Transform Attribute Syntax ==
=== Replace === 
If more than one element is selected, only the first selected element is replaced
 Transform="Replace"
=== Insert ===
The new element is added at the end of any collection.
 Transform="Insert"
<pre class="brush:xml">
<configuration xmlns:xdt="...">
  <connectionStrings>
    <add name="AWLT" connectionString="newstring"
       providerName="newprovider"
       xdt:Transform="Insert" />
  </connectionStrings>
</configuration>
</pre>

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

=== InsertAfter ===
 Transform="InsertAfter(XPath expression)"
<pre class="brush:xml">
<configuration xmlns:xdt="...">
  <authorization>
    <deny users="UserName"
      xdt:Transform="InsertAfter
        (/configuration/system.web/authorization/allow[@roles='Admins'])" />
  </authorization>
</configuration>
</pre>
=== Remove ===
 Transform="Remove"
<pre class="brush:xml">
<configuration xmlns:xdt="...">
  <connectionStrings>
    <add xdt:Transform="Remove" />
  </connectionStrings>
</configuration>
</pre>
=== RemoveAll ===
 Transform="RemoveAll"

<pre class="brush:xml">
<configuration xmlns:xdt="...">
  <connectionStrings>
    <add xdt:Transform="RemoveAll" />
  </connectionStrings>
</configuration>
</pre>

=== RemoveAttributes ===

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

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

=== SetAttributes ===
 Transform="SetAttributes(comma-delimited list of one or more attribute names)"
<pre class="brush:xml">
<configuration xmlns:xdt="...">
  <compilation 
    batch="false"
    xdt:Transform="SetAttributes(batch)">
  </compilation>
</configuration>
</pre>





== Omitting Locator Attributes ==

Locator attributes are optional. If you do not specify a Locator attribute, the element to be changed is specified implicitly by the element that the Transform attribute is specified for. In the following example, the entire system.web element is replaced, because no Locator attribute is specified to indicate otherwise.

<pre class="brush:xml">
<?xml version="1.0"?>
<configuration xmlns:xdt="http://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>
</pre>

== Using Transform and Locator Attributes on Separate Elements ==

A Transform attribute does not have to be set in the same element as a Locator element. You can specify a Locator element on a parent element in order to select elements whose child elements you want to work with. You can then specify a Transform attribute in a child element in order to apply a change to the children.

The following example shows how to use the Locator attribute to select location elements for the specified path. However, only elements that are children of the selected location elements are transformed.

<pre class="brush:xml">
<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>
</pre>

If you specify a Locator attribute but you do not specify a Transform attribute in the same element or in a child element, no changes are made.


=== NoteNote ===


A Transform attribute on a parent element can affect child elements even if no Transform is specified for them. For example, if you put the attribute xdt:Transform="Replace" in the system.web element, all the elements that are children of the system.web element are replaced with the content from the transform file.
 

--------
Check :  [[Accessing Configuration Settings]]