web.config

web.config

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

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

基本介紹

  • 中文名:Web配置文
  • 外文名:web.config
  • 本質:是一個XML文本檔案
  • 作用:用來儲存ASP.NETWeb 的配置信息
  • 出現:在應用程式的每一個目錄中
  • 優點:修改不需要重啟服務就可以生效
配置,配置檔案,自定義,訪問,創建,

配置

Web配置檔案(*.config)

配置檔案

(默認的配置設定)以下所有的代碼都應該位於 <configuration> 和 </configuration>
之間,為了學習的方便和直觀,下面的示例都省略了這段XML標記
1、<authentication> 節
作用:配置ASP.NET身份驗證支持(為Windows、Forms、PassPort、None四種)。該元素只能在計算機、站點或應用程式級別聲明。 元素必需與 節配合使用。
示例:
以下示例為基於窗體(Forms)的身份驗證配置站點,當沒有登入的用戶訪問需要身份驗證的網頁,網頁自動跳轉到登入網頁。
其中元素loginUrl表示登入網頁的名稱,name表示Cookie名稱
2、 <authorization>節
作用:控制對 URL 資源的客戶端訪問(如允許匿名用戶訪問)。該節可以在任何級別(計算機、站點、應用程式、子目錄或頁)上聲明。必需與 節配合使用。
示例:以下示例禁止匿名用戶的訪問
註:你可以使用user.identity.name來獲取已經過驗證的當前的用戶名;可以使用
web.Security.FormsAuthentication.RedirectFromLoginPage方法將已驗證的用戶重定向到用戶剛才請求的頁面.
3、<compilation>節
作用:配置ASP.NET使用的所有編譯設定。默認的debug屬性為“True”.在程式編譯完成交付使用之後應將其設為"False"(Web.config檔案中有詳細說明,此處省略示例)
4、<customErrors> 節
作用:為ASP.NET應用程式提供有關自定義錯誤信息的信息。它不適用於 XML Web services 中發生的錯誤。
示例:當發生錯誤時,將網頁跳轉到自定義的錯誤頁面。
其中元素defaultRedirect表示自定義的錯誤網頁的名稱。mode元素表示:對不在本地 Web 伺服器上運行的用戶顯示自定義信息。
5、<httpRuntime>節
作用:配置 <cite class="highlight" highlight="true">ASP.NET</cite> HTTP 運行庫設定。該節可以在計算機、站點、應用程式和子目錄級別聲明。
示例:控制用戶上傳檔案最大為4M,最長時間為60秒,最多請求數為100
6、<pages> 節
作用:標識特定於頁的配置設定(如是否啟用會話狀態、視圖狀態,是否檢測用戶的輸入等)。該節可以在計算機、站點、應用程式和子目錄級別聲明。
示例:不檢測用戶在瀏覽器輸入的內容中是否存在潛在的危險數據(註:該項默認是檢測,如果你使用了不檢測,一要對用戶的輸入進行編碼或驗證),在從客戶端回發頁時將檢查加密的視圖狀態,以驗證視圖狀態是否已在客戶端被篡改。(註:該項默認是不驗證)
7、<sessionState> 節
作用:為當前應用程式配置會話狀態設定(如設定是否啟用會話狀態,會話狀態保存位置)。
示例:
註:
mode="InProc"表示:在本地儲存會話狀態(你也可以選擇儲存在遠程伺服器或SAL伺服器中或不啟用會話狀態)
cookieless="true"表示:如果用戶瀏覽器不支持Cookie時啟用會話狀態(默認為False)
timeout="20"表示:會話可以處於空閒狀態的分鐘數
8、<trace>節
作用:配置ASP.NET跟蹤服務,主要用來程式測試判斷哪裡出錯。
示例:以下為Web.config中的默認配置:
註:
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 檔案。
示例:獲取上面例子中建立的連線字元串。
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。

相關詞條

熱門詞條

聯絡我們