web.config

web.config

Web.config文件是一個XML文本文件，它用來儲存ASP.NETWeb 應用程序的配置信息（如最常用的設置ASP.NETWeb 應用程序的身份驗證方式），它可以出現在應用程序的每一個目錄中。當你通過.NET新建一個Web應用程序后，默認情況下會在根目錄自動創建一個默認的Web.config文件，包括默認的配置設置，所有的子目錄都繼承它的配置設置。如果你想修改子目錄的配置設置，你可以在該子目錄下新建一個Web.config文件。它可以提供除從父目錄繼承的配置信息以外的配置信息，也可以重寫或修改父目錄中定義的設置。

在運行時對Web.config文件的修改不需要重啟服務就可以生效（註：節例外）。另外Web.config文件也是可以擴展的。你可以自定義新配置參數並編寫配置節處理程序以對它們進行處理。

目錄
1配置 2配置文件 3自定義
4訪問 5創建

配置

配置件(*.)

配置文件

（默配置設置）碼該
，習觀，示例省略段標
1、 節
作用：配置ASP.NET身份驗證支持（為Windows、Forms、PassPort、None四種）。該元素只能在計算機、站點或應用程序級別聲明。元素必需與 節配合使用。
示例：
以下示例為基於窗體（Forms）的身份驗證配置站點，當沒有登陸的用戶訪問需要身份驗證的網頁，網頁自動跳轉到登陸網頁。
其中元素loginUrl表示登陸網頁的名稱，name表示Cookie名稱
2、 節
作用：控制對 URL 資源的客戶端訪問（如允許匿名用戶訪問）。該節可以在任何級別（計算機、站點、應用程序、子目錄或頁）上聲明。必需與 節配合使用。
示例：以下示例禁止匿名用戶的訪問
註：你可以使用user.identity.name來獲取已經過驗證的當前的用戶名；可以使用
web.Security.FormsAuthentication.RedirectFromLoginPage方法將已驗證的用戶重定向到用戶剛才請求的頁面.
3、節
作用：配置ASP.NET使用的所有編譯設置。默認的debug屬性為“True”.在程序編譯完成交付使用之後應將其設為"False"（Web.config文件中有詳細說明，此處省略示例）
4、 節
作用：為ASP.NET應用程序提供有關自定義錯誤信息的信息。它不適用於 XML Web services 中發生的錯誤。
示例：當發生錯誤時，將網頁跳轉到自定義的錯誤頁面。
其中元素defaultRedirect表示自定義的錯誤網頁的名稱。mode元素表示：對不在本地 Web 伺服器上運行的用戶顯示自定義信息。
5、節
作用：配置 ASP.NET HTTP 運行庫設置。該節可以在計算機、站點、應用程序和子目錄級別聲明。
示例：控制用戶上傳文件最大為4M，最長時間為60秒，最多請求數為100
6、<pages> 節
作用：標識特定於頁的配置設置（如是否啟用會話狀態、視圖狀態，是否檢測用戶的輸入等）。該節可以在計算機、站點、應用程序和子目錄級別聲明。
示例：不檢測用戶在瀏覽器輸入的內容中是否存在潛在的危險數據（註：該項默認是檢測，如果你使用了不檢測，一要對用戶的輸入進行編碼或驗證)，在從客戶端回發頁時將檢查加密的視圖狀態，以驗證視圖狀態是否已在客戶端被篡改。(註：該項默認是不驗證）
7、 節
作用：為當前應用程序配置會話狀態設置（如設置是否啟用會話狀態，會話狀態保存位置）。
示例：
註：
mode="InProc"表示：在本地儲存會話狀態（你也可以選擇儲存在遠程伺服器或SAL伺服器中或不啟用會話狀態）
cookieless="true"表示：如果用戶瀏覽器不支持Cookie時啟用會話狀態(默認為False）
timeout="20"表示：會話可以處於空閑狀態的分鐘數
8、節
作用：配置ASP.NET跟蹤服務，主要用來程序測試判斷哪裡出錯。
示例：以下為Web.config中的默認配置：
註：
enabled="false"表示不啟用跟蹤；requestLimit="10"表示指定在伺服器上存儲的跟蹤請求的數目
pageOutput="false"表示只能通過跟蹤實用工具訪問跟蹤輸出；
traceMode="SortByTime"表示以處理跟蹤的順序來顯示跟蹤信息
localOnly="true" 表示跟蹤查看器 (trace.axd) 只用於宿主 Web 伺服器

自定義

自定義WeB.CONFIG文件配置
自定義Web.config文件配置節過程分為兩步。
一是在在配置文件頂部 和 標記之間聲明配置節的名稱和處理該節中配置數據的 .NET Framework 類的名稱。
二是在 區域之後為聲明的節做實際的配置設置。
示例：創建一個節存儲資料庫連接字元串
uid=sa;pwd=123"/>
......

訪問

訪問WEB.CONFIG文件
你可以通過使用ConfigurationSettings.AppSettings 靜態字元串集合來訪問 Web.config 文件。
示例：獲取上面例子中建立的連接字元串。
vb.net
Dim sconstr As String = System.Configuration.ConfigurationManager.AppSettings("ConnectionString")
c#
string　connectionString =System.Configuration.ConfigurationManager.AppSettings["ConnectionString"];

創建

創建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配置文
外文名
web.config
作用
用來儲存ASP.NETWeb 的配置信息
優勢
修改不需要重啟服務就可以生效
本質
是一個XML文本文件
出現
在應用程序的每一個目錄中