詳解ASP.NET設定檔Web.config

Web.config檔案是一個XML文字文件，它用來儲存ASP.NET Web 應用程式的設定資訊（如最常用的設定ASP.NET Web 應用程式的驗證方式），它可以出現在應用程式的每一個目錄中。當你透過VB.NET新建一個Web應用程式後，預設會在根目錄自動建立一個預設的Web.config文件，包括預設的設定設置，所有的子目錄都繼承它的設定。如果你想要修改子目錄的設定設置，你可以在該子目錄下新建一個 Web.config檔。它可以提供從父目錄繼承的配置資訊以外的配置信息，也可以重寫或修改父目錄中定義的設定。

在執行時對Web.config檔的修改不需要重新啟動服務就可以生效（註： 節例外）。當然Web.config檔是可以擴充的。你可以自訂新配置參數並編寫配置節處理程序以對它們進行處理。

一、web.config設定檔（預設的設定）

以下所有的程式碼都應該位於

和

/configuration>

之間，出於學習的目的下面的範例都省略了這段XML標記

1、 節

作用：設定ASP.NET 驗證支援（為Windows、Forms、PassPort、 None四種）。該元素只能在電腦、網站或應用程式層級聲明。 元素必須與 節搭配使用。

範例：

以下範例為基於窗體（Forms）的身份驗證設定站點，當沒有登陸的使用者造訪需要驗證的網頁，網頁會自動跳到登陸網頁。

<authentication mode="Forms" >  
<forms loginUrl="logon.aspx" name=".FormsAuthCookie"/>  
</authentication>

其中元素loginUrl表示登陸網頁的名稱，name表示Cookie名稱

2、 節

作用：控制對 URL 資源的用戶端存取（如允許匿名使用者存取）。此元素可以在任何層級（電腦、網站、應用程式、子目錄或頁面）上聲明。必需與 節搭配使用。

範例：以下範例禁止匿名使用者的存取

<authorization>  
<deny users="?"/>  
</authorization>

註：你可以使用user.identity.name來取得已經驗證的目前的使用者名稱；可以使用web.Security.FormsAuthentication.RedirectFromLoginPage方法將已驗證的使用者重定向到使用者剛才要求的頁面.

3、節

作用：配置ASP.NET 使用的所有編譯設定。預設的debug屬性為「True」.在程式編譯完成交付使用之後應將其設為True（Web.config檔中有詳細說明，此處省略範例）

4、

作用：為ASP .NET 應用程式提供有關自訂錯誤訊息的資訊。它不適用於 XML Web services 中發生的錯誤。

範例：當發生錯誤時，將網頁跳到自訂的錯誤頁面。

<customErrors defaultRedirect="ErrorPage.aspx" mode="RemoteOnly">  
</customErrors>

其中元素defaultRedirect表示自訂的錯誤網頁的名稱。 mode元素表示：對不在本機 Web 伺服器上執行的使用者顯示自訂(友善的)資訊。

5、節

作用：配置 ASP.NET HTTP 運行庫設定。該節可以在電腦、網站、應用程式和子目錄層級聲明。

範例：控制使用者上傳檔案最大為4M，最長時間為60秒，最多請求數為100

<httpRuntime maxRequestLength="4096" executi appRequestQueueLimit="100"/>

6、

作用：標識特定於頁的設定設定（如是否啟用會話狀態、視圖狀態，是否偵測使用者的輸入等）。 可以在電腦、網站、應用程式和子目錄層級聲明。

範例：不檢測使用者在瀏覽器輸入的內容中是否存在潛在的危險資料（註：該項預設是偵測，如果你使用了不偵測，一要對使用者的輸入進行編碼或驗證)，在從客戶端回發頁時將檢查加密的視圖狀態，以驗證視圖狀態是否已在客戶端被竄改。 (註：該項目預設為不驗證）

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

7、

作用：為目前應用程式設定會話狀態設定（如設定是否啟用會話狀態，會話狀態儲存位置）。

範例：

<sessionState mode="InProc" cookieless="true" timeout="20"/>  
</sessionState>

註：

mode="InProc"表示：在本地儲存會話狀態（你也可以選擇儲存在遠端伺服器或SAL伺服器中或不啟用會話狀態）

cookieless="true"表示：如果使用者瀏覽器不支援Cookie時啟用會話狀態(預設為False）

timeout="20"表示：會話可以處於空閒狀態的分鐘數

8、

作用：設定ASP.NET 追蹤服務，主要用來程序測試判斷哪裡出錯。

範例：以下為Web.config中的預設設定：

<trace enabled="false" requestLimit="10" pageOutput="false" traceMode="SortByTime" localOnly="true" />

註：

enabled="false"表示不启用跟踪；requestLimit="10"表示指定在服务器上存储的跟踪请求的数目

pageOutput="false"表示只能通过跟踪实用工具访问跟踪输出；

traceMode="SortByTime"表示以处理跟踪的顺序来显示跟踪信息

localOnly="true" 表示跟踪查看器 (trace.axd) 只用于宿主 Web 服务器

二、自定义Web.config文件配置节

自定义Web.config文件配置节过程分为两步。

一是在在配置文件顶部 和 标记之间声明配置节的名称和处理该节中配置数据的 .NET Framework 类的名称。

二是在 区域之后为声明的节做实际的配置设置。

示例：创建一个节存储数据库连接字符串

<configuration>  
<configSections>  
<section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
</configSections> 
<appSettings>  
<add key="scon" value="server=a;database=northwind;uid=sa;pwd=123"/>  
</appSettings>  
<system.web>  
......  
</system.web>  
</configuration>

三、访问Web.config文件

你可以通过使用ConfigurationSettings.AppSettings 静态字符串集合来访问 Web.config 文件示例：获取上面例子中建立的连接字符串。

四、创建Web.config文件

1.在“解决方案资源管理器”中，单击“刷新”图标以确认应用程序还没有 Web.config 文件。

如果已使用网站管理工具或某些其他方式来配置应用程序，则可能已自动创建了 Web.config 文件。单击“刷新”更新文件列表。

2.在“解决方案资源管理器”中，右击网站名称，然后单击“添加新项”。

3.在“模板”窗口中，单击“Web 配置文件”。

“名称”文本框中的文件名应为Web.config。可以为该文件提供其他名称，不过这是默认名称。.config 文件扩展名可防止 ASP.NET 下载相应文件。

4.单击“添加”创建该文件，然后将其打开进行编辑。

该文件包含本主题后面“示例”部分中显示的代码，并具有一些初始默认值。应用程序从 %SystemRoot%\Microsoft.NET\Framework\\CONFIG 目录下的 Machine.config 和 Web.config 文件继承所有配置设置，但在此处看不到这些默认设置。如果要重写继承的默认设置或添加 httpHandlers 元素（ASP.NET 设置架构） 等集合元素，则只需创建应用程序级别和目录级别的 Web.config 文件。

若要查看当前应用程序的所有配置设置，可以运行主题如何：以编程方式查看继承的配置设置和本地配置设置中包含的代码。也可以查看 %SystemRoot%\Microsoft.NET\Framework\\CONFIG 目录下的Machine.config.comments 或 Web.config.comments 文件（这两个文件也包含有用的注释），但这两个文件将不会包含所有运行时设置，请参见如何：以编程方式查看继承的配置设置和本地配置设置。

5.如果更改了 Web.config 文件，则保存该文件。

保存 Web.config 文件会重新启动应用程序。也可以选择使用单个节元素的 configSource 属性指向某个辅助配置文件，更改辅助配置文件不会导致应用程序重新启动。有关更多信息，请参见节元素所继承的常规属性中的 configSource。

Web.config是asp.net应用程序中一个很重要的配置文件，通过Web.config文件可以方便我们进行开发和部署asp.net应用程序。

通过本文的介绍，希望对你有帮助，对ASP.NET配置文件Web.config有更深入的了解。

更多詳解ASP.NET設定檔Web.config相关文章请关注PHP中文网！