Web.config 詳解

http://www.cnblogs.com/guozhe/archive/2012/04/18/2455125.html

在開發中經常會遇到這樣的情況,在部署程序時爲了保密起見並不將源代碼隨項目一同發佈,而我們開發時的環境與部署環境可能不一致(比如數據庫不一樣),如果在代碼中保存這些配置這些信息部署時需要到用戶那裏更改代碼再重新編譯,這種部署方式非常麻煩。
在.net 中提供了一種便捷的保存項目配置信息的辦法,那就是利用配置文件,配置文件的文件後綴一般是.config,在asp.net中配置文件名一般默認是 web.config。每個web.config文件都是基於XML的文本文件,並且可以保存到Web應用程序中的任何目錄中。在發佈Web應用程序時 web.config文件並不編譯進dll文件中。如果將來客戶端發生了變化,僅僅需要用記事本打開web.config文件編輯相關設置就可以重新正常 使用,非常方便。
本篇要講述的知識如下:
配置文件的查找優先級

配置文件節點說明
配置文件的操作

配置文件的查找優先級
在.net提供了一個針對當前機器的配置文件,這個文件是 machine.config,它位於%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/文件下 (%windir%是系統分區下的系統目錄,在命令行模式下輸入%windir%然後回車就能查看當前機器的系統目錄,在Windows2003及 WindowsXP中%windir%是系統分區下的windows目錄,在Windows2000中%windir%是系統分區下的WinNT目錄,在 筆者機器上這個系統目錄是C:/WINDOWS)。這個文件裏面定義了針對當前機器的WinForm程序和asp.net應用程序的配置。下面是 machine.config文件的內容:

在這個文件夾下還有一個web.config文件,這個文件包含了asp.net網站的常用配置。下面是這個web.config文件的內容:

asp.net網站IIS啓動的時候會加載配置文件中的配置信息,然後緩存這些信息,這樣就不必每次去讀取配置信息。在運行過程中asp.net應用程序會監視配置文件的變化情況,一旦編輯了這些配置信息,就會重新讀取這些配置信息並緩存。
當我們要讀取某個節點或者節點組信息時,是按照如下方式搜索的:
(1)如果在當前頁面所在目錄下存在web.config文件,查看是否存在所要查找的結點名稱,如果存在返回結果並停止查找。
(2)如果當前頁面所在目錄下不存在web.config文件或者web.config文件中不存在該結點名,則查找它的上級目錄,直到網站的根目錄。
(3)如果網站根目錄下不存在web.config文件或者web.config文件中不存在該節點名則在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/web.config文件中查找。
(4) 如果在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/web.config文件中不存在相應 結點,則在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/machine.config文件 中查找。
(5)如果仍然沒有找到則返回null。
所以如果我們對某個網站或者某個文件夾有特定要求的配置,可以在相應的文件夾下創建一個 web.config文件,覆蓋掉上級文件夾中的web.config文件中的同名配置即可。這些配置信息的尋找只查找一次,以後便被緩存起來供後來的調 用。在asp.net應用程序運行過程中,如果web.config文件發生更改就會導致相應的應用程序重新啓動,這時存儲在服務器內存中的用戶會話信息 就會丟失(如存儲在內存中的Session)。一些軟件(如殺毒軟件)每次完成對web.config的訪問時就會修改web.config的訪問時間屬 性,也會導致asp.net應用程序的重啓。

配置文件節點說明
web.config文件是一個XML文件,它的根結點 是<configuration>,在<configuration>節點下的常見子節點 有:<configSections>、<appSettings>、<connectionStrings> 和<system.web>。其中<appSettings>節點主要用於配置一些網站的應用配置信息, 而<connectionStrings>節點主要用於配置網站的數據庫連接字符串信息。
<system.web>節點主要是網站運行時的一些配置,它的常見節點有如下:
<appSettings>節點
<appSettings>節點主要用來存儲asp.net應用程序的一些配置信息,比如上傳文件的保存路徑等,以下是一個例子:

  1. <appSettings>
  2.     <!--允許上傳的圖片格式類型-->
  3.     <add key="ImageType" value=".jpg;.bmp;.gif;.png;.jpeg"/>
  4.     <!--允許上傳的文件類型-->
  5.     <add key="FileType" value=".jpg;.bmp;.gif;.png;.jpeg;.pdf;.zip;.rar;.xls;.doc"/>
  6. </appSettings>

對於<appSettings>節點中的值可以按照key來進行訪問,以下就是一個讀取key值爲“FileType”節點值的例子:

  1. string fileType=ConfigurationManager.AppSettings["FileType "];

<connectionStrings>節點
<connectionStrings> 節點主要用於配置數據庫連接的,我們可以<connectionStrings>節點中增加任意個節點來保存數據庫連接字符串,將來在代碼中 通過代碼的方式動態獲取節點的值來實例化數據庫連接對象,這樣一旦部署的時候數據庫連接信息發生變化我們僅需要更改此處的配置即可,而不必因爲數據庫連接 信息的變化而需要改動程序代碼和重新部署。
以下就是一個<connectionStrings>節點配置的例子:

  1. <connectionStrings>
  2.     <!--SQL Server數據庫配置-->
  3.     <add name="AspNetStudyConnectionString1" connectionString="Data Source=(local);Initial Catalog=AspNetStudy;User ID=sa;Password=sa"/>
  4. </connectionStrings>

在代碼中我們可以這麼實例化數據庫連接對象:

  1. //讀取web.config節點配置
  2. string connectionString = ConfigurationManager.ConnectionStrings["AspNetStudyConnectionString1"].ConnectionString;
  3. //實例化SqlConnection對象
  4. SqlConnection connection = new SqlConnection(connectionString);

這樣做的好處是一旦開發時所用的數據庫和部署時的數據庫不一致,僅僅需要用記事本之類的文本編輯工具編輯connectionString屬性的值就行了。

<compilation>節點
<compilation>節點配置 ASP.NET 使用的所有編譯設置。默認的debug屬性爲“true”,即允許調試,在這種情況下會影響網站的性能,所以在程序編譯完成交付使用之後應將其設爲“false”。

<authentication>節點
設置asp.net身份驗證模式,有四種身份驗證模式,它們的值分別如下:
Mode 說明
Windows 使用Windows身份驗證,適用於域用戶或者局域網用戶。
Forms 使用表單驗證,依靠網站開發人員進行身份驗證。
Passport 使用微軟提供的身份驗證服務進行身份驗證。
None 不進行任何身份驗證。

<authentication>節點
<authentication>節點控制用戶對網站、目錄或者單獨頁的訪問,必須配合<authentication>節點一起使用。

<customErrors>節點
<customErrors>節點用於定義 一些自定義錯誤信息的信息。此節點有Mode和defaultRedirect兩個屬性,其中defaultRedirect屬性是一個可選屬性,表示應 用程序發生錯誤時重定向到的默認URL,如果沒有指定該屬性則顯示一般性錯誤。Mode屬性是一個必選屬性,它有三個可能值,它們所代表的意義分別如下:
Mode 說明
On 表示在本地和遠程用戶都會看到自定義錯誤信息。
Off 禁用自定義錯誤信息,本地和遠程用戶都會看到詳細的錯誤信息。
RemoteOnly 表示本地用戶將看到詳細錯誤信息,而遠程用戶將會看到自定義錯誤信息。
這 裏有必要說明一下本地用戶和遠程用戶的概念。當我們訪問asp.net應用程時所使用的機器和發佈asp.net應用程序所使用的機器爲同一臺機器時成爲 本地用戶,反之則稱之爲遠程用戶。在開發調試階段爲了便於查找錯誤Mode屬性建議設置爲Off,而在部署階段應將Mode屬性設置爲On或者 RemoteOnly,以避免這些詳細的錯誤信息暴露了程序代碼細節從而引來黑客的入侵。
下面我們添加一個頁面CustomErrorsDemo.aspx,在它的Page_Load事件裏拋出一個異常,代碼如下:


  1. using System;
  2. using System.Data;
  3. using System.Configuration;
  4. using System.Collections;
  5. using System.Web;
  6. using System.Web.Security;
  7. using System.Web.UI;
  8. using System.Web.UI.WebControls;
  9. using System.Web.UI.WebControls.WebParts;
  10. using System.Web.UI.HtmlControls;
  11. public partial class CustomErrorsDemo : System.Web.UI.Page
  12. {
  13.     protected void Page_Load(object sender, EventArgs e)
  14.     {
  15.         throw new Exception("故意拋出的異常。");
  16.     }
  17. }

我們先配置<customErrors>如下:

  1. <customErrors mode="RemoteOnly">
  2.      <error statusCode="403" redirect="NoAccess.htm" />
  3.      <error statusCode="404" redirect="FileNotFound.htm" />
  4. </customErrors>

這時本地運行CustomErrorsDemo.aspx的效果如下:

遠程訪問時看到的效果:

如果我們將customErrors的Mode屬性設置爲“On”本地運行和遠程訪問都會看到如下效果:

如果將customErrors的Mode屬性設置爲“Off”本地運行和遠程訪問都會看到如下效果:

<error>子節點
在<customErrors>節點下還包含 有<error>子節點,這個節點主要是根據服務器的HTTP錯誤狀態代碼而重定向到我們自定義的錯誤頁面,注意要 使<error>子節點下的配置生效,必須將<customErrors>節點節點的Mode屬性設置爲“On”。下面是一個例 子:

  1. <customErrors mode="On" defaultRedirect="GenericErrorPage.htm">
  2.      <error statusCode="403" redirect="403.htm" />
  3.      <error statusCode="404" redirect="404.htm" />
  4. </customErrors>


在上面的配置中如果用戶訪問的頁面不存在就會跳轉到404.htm頁面,如果用戶沒有權限訪問請求的頁面則會跳轉到403.htm頁面,403.htm和404.htm頁面都是我們自己添加的頁面,我們可以在頁面中給出友好的錯誤提示。

<httpHandlers>節點
<httpHandlers>節點用於根據用戶請求的URL和HTTP謂詞將用戶的請求交給相應的處理程序。可以在配置級別的任何層次配置此節點,也就是說可以針對某個特定目錄下指定的特殊文件進行特殊處理。

下面是與machine.config文件同一目錄下的web.config文件中的<httpHandlers>節點配置:


  1. <httpHandlers>
  2.             <add path="*.rules" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  3.             <add path="*.xoml" verb="*" type="System.ServiceModel.Activation.HttpHandler, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/>
  4.             <add path="trace.axd" verb="*" type="System.Web.Handlers.TraceHandler" validate="true"/>
  5.             <add path="WebResource.axd" verb="GET" type="System.Web.Handlers.AssemblyResourceLoader" validate="true"/>
  6.             <add path="*.axd" verb="*" type="System.Web.HttpNotFoundHandler" validate="true"/>
  7.             <add path="*.aspx" verb="*" type="System.Web.UI.PageHandlerFactory" validate="true"/>
  8.             <add path="*.ashx" verb="*" type="System.Web.UI.SimpleHandlerFactory" validate="true"/>
  9.             <add path="*.asmx" verb="*" type="System.Web.Services.Protocols.WebServiceHandlerFactory, System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" validate="false"/>
  10.             <add path="*.rem" verb="*" type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/>
  11.             <add path="*.soap" verb="*" type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/>
  12.             <add path="*.asax" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  13.             <add path="*.ascx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  14.             <add path="*.master" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  15.             <add path="*.skin" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  16.             <add path="*.browser" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  17.             <add path="*.sitemap" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  18.             <add path="*.dll.config" verb="GET,HEAD" type="System.Web.StaticFileHandler" validate="true"/>
  19.             <add path="*.exe.config" verb="GET,HEAD" type="System.Web.StaticFileHandler" validate="true"/>
  20.             <add path="*.config" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  21.             <add path="*.cs" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  22.             <add path="*.csproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  23.             <add path="*.vb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  24.             <add path="*.vbproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  25.             <add path="*.webinfo" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  26.             <add path="*.licx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  27.             <add path="*.resx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  28.             <add path="*.resources" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  29.             <add path="*.mdb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  30.             <add path="*.vjsproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  31.             <add path="*.java" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  32.             <add path="*.jsl" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  33.             <add path="*.ldb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  34.             <add path="*.ad" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  35.             <add path="*.dd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  36.             <add path="*.ldd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  37.             <add path="*.sd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  38.             <add path="*.cd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  39.             <add path="*.adprototype" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  40.             <add path="*.lddprototype" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  41.             <add path="*.sdm" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  42.             <add path="*.sdmDocument" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  43.             <add path="*.mdf" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  44.             <add path="*.ldf" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  45.             <add path="*.exclude" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  46.             <add path="*.refresh" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/>
  47.             <add path="*.svc" verb="*" type="System.ServiceModel.Activation.HttpHandler, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/>
  48.             <add path="*" verb="GET,HEAD,POST" type="System.Web.DefaultHttpHandler" validate="true"/>
  49.             <add path="*" verb="*" type="System.Web.HttpMethodNotAllowedHandler" validate="true"/>
  50.         </httpHandlers>

從上面的配置中可以看出,針對*.mdf、*.ldf文件的Get或者Post請求都會交給 System.Web.HttpForbiddenHandler來處理,處理的結果就是用戶不能查看或者下載相關的文件。如果我們某個文件夾下的文件或 者某個類型的文件不允許用戶下載,可以在</httpHandlers>節點中增加相應的子節點。
下面我們以一個例子來說明<httpHandlers>節點的用法,在我們的asp.net應用程序中建立一個IPData目錄,在IPData目錄中創建一個IPData.txt文件,然後在Web.config中添加以下配置:

  1. <httpHandlers>
  2.       <add path="IPData/*.txt" verb="*" type="System.Web.HttpForbiddenHandler"/>
  3. </httpHandlers>

上面的代碼的作用是禁止訪問IPData目錄下的任何txt文件。
然後新建一個頁面,在頁面中添加一個超級鏈接,鏈接到該目錄下IPData.txt文件,代碼如下:


  1. <%@ Page Language="C#" AutoEventWireup="true" CodeFile="HttpHandlersDemo.aspx.cs" Inherits="HttpHandlersDemo" %>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" >
  4. <head runat="server">
  5.     <title>httpHandlers節點的例子</title>
  6. </head>
  7. <body>
  8.     <form id="form1" runat="server">
  9.     <div>
  10.     <a href="IPData/IPData.txt" title="打開IPData/IPData.txt">打開IPData/IPData.txt</a>
  11.     </div>
  12.     </form>
  13. </body>
  14. </html>

運行這個頁面的效果如下:

當前web.config文件的<customErrors>節點配置如下:
<customErrors mode="On" defaultRedirect="GenericErrorPage.htm">
     <error statusCode="403" redirect="403.htm" />
     <error statusCode="404" redirect="404.htm" />
</customErrors>
如果存在403.htm和404.htm頁面,點擊超級鏈接之後會出現如下效果:

我們從上圖中可以看到當<customErrors>節點的Mode屬性爲“On”時,因爲被禁止訪問IPData文件夾下的所有txt文件,所以會跳轉到自定義的沒有權限提示頁面,即403.htm。

<httpRuntime>節點
<httpRuntime>節點用於對 ASP.NET HTTP 運行庫設置。該節可以在計算機、站點、應用程序和子目錄級別聲明。
例如下面的配置控制用戶最大能上傳的文件爲40M(40*1024K),最大超時時間爲60秒,最大併發請求爲100個。

  1. <httpRuntime maxRequestLength="40960" executionTimeout="60" appRequestQueueLimit="100"/>

<pages>節點
<pages>節點用於表示對特定頁設置,主要有三個屬性,分別如下:
屬性名 說明
buffer 是否啓用了 HTTP 響應緩衝。
enableViewStateMac 是否應該對頁的視圖狀態運行計算機身份驗證檢查 (MAC),以放置用戶篡改,默認爲false,如果設置爲true將會引起性能的降低。
validateRequest 是 否驗證用戶輸入中有跨站點腳本攻擊和SQL注入式漏洞攻擊,默認爲true,如果出現匹配情況就會發 HttpRequestValidationException 異常。對於包含有在線文本編輯器頁面一般自行驗證用戶輸入而將此屬性設爲false。
下面就是一個配置節點的例子:

  1. <pages buffer="true" enableViewStateMac="true" validateRequest="false"/>

<sessionState>節點
<sessionState>節點用於配置當前asp.net應用程序的會話狀態配置。以下就是一個常見配置:

  1. <sessionState cookieless="false" mode="InProc" timeout="30" />

上面的節點配置是設置在asp.net應用程序中啓用Cookie,並且指定會話狀態模式爲在進程中保存會話狀態,同時還指定了會話超時爲30分鐘。
<sessionState>節點的Mode屬性可以是以下幾種值之一:
屬性值 說明
Custom 使用自定義數據來存儲會話狀態數據。
InProc 默認值。由asp.net輔助進程來存儲會話狀態數據。
Off 禁用會話狀態。
SQLServer 使用進程外SQL Server數據庫保存會話狀態數據。
StateServer 使用進程外 ASP.NET 狀態服務存儲狀態信息。
一般默認情況下使用InProc模式來存儲會話狀態數據,這種模式的好處是存取速度快,缺點是比較佔用內存,所以不宜在這種模式下存儲大型的用戶會話數據。

<globalization>節點:
用於配置應用程序的全球化設置。此節點有幾個比較重要的屬性,分別如下:
屬性名 說明
fileEncoding 可選屬性。設置.aspx、.asmx 和 .asax 文件的存儲編碼。
requestEncoding 可選屬性。設置客戶端請求的編碼,默認爲UTF-8.
responseEncoding 可選屬性。設置服務器端響應的編碼,默認爲UTF-8.
以下就是asp.net應用程序中的默認配置:

  1. <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8"/>

配置文件的讀寫操作
雖然web.config文件是一個XML文件,但是由於權限的原因它在部署中不能像操作普通XML文件那樣進行修改,在.net中提供了一個類用於對web.config進行修改。
下面是針對web.config修改通用類的代碼:


  1. using System;
  2. using System.Configuration;
  3. using System.Web;
  4. using System.Web.Configuration;
  5. /// <summary>
  6. /// ConfigurationOperator 的摘要說明
  7. /// </summary>
  8. public class ConfigurationOperator:IDisposable
  9. {
  10.     private Configuration config;
  11. public ConfigurationOperator():this(HttpContext.Current.Request.ApplicationPath)
  12. {
  13.        
  14. }
  15.     public ConfigurationOperator(string path)
  16.     {
  17.         config = WebConfigurationManager.OpenWebConfiguration(path);
  18.     }
  19.     /// <summary> 
  20.     /// 設置應用程序配置節點,如果已經存在此節點,則會修改該節點的值,否則添加此節點
  21.     /// </summary> 
  22.     /// <param name="key">節點名稱</param> 
  23.     /// <param name="value">節點值</param> 
  24.     public void SetAppSetting(string key, string value)
  25.     {
  26.         AppSettingsSection appSetting = (AppSettingsSection)config.GetSection("appSettings");
  27.         if (appSetting.Settings[key] == null)//如果不存在此節點,則添加 
  28.         {
  29.             appSetting.Settings.Add(key, value);
  30.         }
  31.         else//如果存在此節點,則修改 
  32.         {
  33.             appSetting.Settings[key].Value = value;
  34.         }
  35.     }
  36.     /// <summary> 
  37.     /// 設置數據庫連接字符串節點,如果不存在此節點,則會添加此節點及對應的值,存在則修改 
  38.     /// </summary> 
  39.     /// <param name="key">節點名稱</param> 
  40.     /// <param name="value">節點值</param> 
  41.     public void SetConnectionString(string key, string connectionString)
  42.     {
  43.         ConnectionStringsSection connectionSetting = (ConnectionStringsSection)config.GetSection("connectionStrings");
  44.         if (connectionSetting.ConnectionStrings[key] == null)//如果不存在此節點,則添加 
  45.         {
  46.             ConnectionStringSettings connectionStringSettings = new ConnectionStringSettings(key, connectionString);
  47.             connectionSetting.ConnectionStrings.Add(connectionStringSettings);
  48.         }
  49.         else//如果存在此節點,則修改 
  50.         {
  51.             connectionSetting.ConnectionStrings[key].ConnectionString = connectionString;
  52.         }
  53.     }
  54.     /// <summary> 
  55.     /// 保存所作的修改 
  56.     /// </summary> 
  57.     public void Save()
  58.     {
  59.         config.Save();
  60.         config = null;
  61.     }
  62.     public void Dispose()
  63.     {
  64.         if (config != null)
  65.         {
  66.             config.Save();
  67.         }
  68.     }
  69. }

把上面的代碼存放到App_Code文件夾下,我們在項目中就可以直接使用了。
我們通過一個例子演示如果使用這個通用類對web.config進行設置。新建一個aspx頁面,下面是前臺代碼:


  1. <%@ Page Language="C#" AutoEventWireup="true" CodeFile="ConfigModifyDemo.aspx.cs" Inherits="ConfigModifyDemo" %>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" >
  4. <head runat="server">
  5.     <title>在部署後修改web.config的例子</title>
  6. </head>
  7. <body>
  8.     <form id="form1" runat="server">
  9.     <div>
  10.     <table border="0" cellpadding="0" cellspacing="0">
  11.     <tr><td>類型</td><td>名稱</td><td></td></tr>
  12.     <tr><td>
  13.         程序配置</td><td>
  14.             <asp:TextBox ID="txtKey" runat="server"></asp:TextBox>
  15.             <asp:RequiredFieldValidator ID="RequiredFieldValidator2" runat="server" ControlToValidate="txtKey"
  16.                 ErrorMessage="*" Display="Dynamic"></asp:RequiredFieldValidator></td><td>
  17.         <asp:TextBox ID="txtAppSetting" runat="server"></asp:TextBox></td></tr>
  18.     <tr><td>
  19.         數據庫連接</td><td>
  20.             <asp:TextBox ID="txtConnectionName" runat="server"></asp:TextBox>
  21.             <asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" ErrorMessage="*" ControlToValidate="txtConnectionName" Display="Dynamic"></asp:RequiredFieldValidator></td><td style="height: 24px">
  22.         <asp:TextBox ID="txtConnectionString" runat="server"></asp:TextBox></td></tr>
  23.     <tr><td>
  24.         <asp:Button ID="btnModify" runat="server" OnClick="btnModify_Click" Text="修改" /></td><td></td><td></td></tr>
  25.     </table>
  26.     </div>
  27.     </form>
  28. </body>
  29. </html>


編寫後臺代碼有時可能需要增加對配置文件讀寫操作類所在dll的引用,如下:

下面是後臺代碼:

  1. using System;
  2. using System.Data;
  3. using System.Configuration;
  4. using System.Collections;
  5. using System.Web;
  6. using System.Web.Security;
  7. using System.Web.UI;
  8. using System.Web.UI.WebControls;
  9. using System.Web.UI.WebControls.WebParts;
  10. using System.Web.UI.HtmlControls;
  11. using System.Web.Configuration;//注意添加這個命名空間
  12. public partial class ConfigModifyDemo : System.Web.UI.Page
  13. {
  14.     protected void Page_Load(object sender, EventArgs e)
  15.     {
  16.     }
  17.     protected void btnModify_Click(object sender, EventArgs e)
  18.     {
  19.         string appSetting = txtAppSetting.Text;//appSetting子節點值
  20.         string connectionString = txtConnectionString.Text;//連接字符串
  21.         string key = txtKey.Text;//appSetting子節點Key
  22.         string connectionName = txtConnectionName.Text;//連接Name
  23.         ConfigurationOperator op = new ConfigurationOperator();
  24.         op.SetAppSetting(key, appSetting);
  25.         op.SetConnectionString(connectionName, connectionString);
  26.         op.Save();
  27.     }
  28.    
  29. }

下面是運行界面:

我們在上面的表單中填入如下信息:

假設此時web.config文件相關節點的內容如下:

  1. <appSettings>
  2.   </appSettings>
  3.   <connectionStrings>
  4.     <add name="Conn" connectionString="Data Source=(local);Initial Catalog=AspNetStudy;Persist Security Info=True;User ID=sa;Password=sa" />
  5.   </connectionStrings>

我們點擊“修改”按鈕之後的文件內容如下:

  1. <appSettings>
  2.     <add key="country" value="china" />
  3.   </appSettings>
  4.   <connectionStrings>
  5.     <add name="Conn" connectionString="Data Source=(local);Initial Catalog=Study;User ID=sa;Password=sa"
  6.       providerName="System.Data.SqlClient" />
  7.   </connectionStrings>

從執行結果可以看出我們的程序確實能做到修改和添加web.config中的節點的功能。需要注意的是,在利用了某些版本控制軟件之後(如 Microsoft Visual SourceSafe),版本控制軟件可能會將web.config設置爲只讀屬性,就會出現不能設置的情況,我們需要手動將web.config的只讀 屬性去掉才能設置web.config文件。在實際部署項目的時候就不會存在這個問題。

總結:web.config是asp.net應用程序中一個很重要的配置文件,通過web.config文件可以方便我們進行開發和部署 asp.net應用程序。此外還能對程序進行一些靈活的控制。在本篇中詳細講述了各節點的作用。因爲在部署asp.net應用程序後因爲權限原因不能按照 XML方式進行修改web.config文件,所以在本篇中還提供了一個針對<appSettings>節點 和<connectionStrings>節點設置的通用類,讀者朋友可以根據實際項目需要對這個通用類進行完善和補充。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章