配置文件入門 - WebConfig.config常用配置節點介紹
一、配置文件入門
.Net提供了一種保存項目配置信息的辦法,就是利用配置文件,配置文件的後綴一般是.config。在WinForm程序中配置文件一般是App.config。在Asp.net中一般默認是web.config。
一個.config配置文件都是基於XML的文本文件,並且可以保存到Web應用程序中的任何目錄中。在發布Web應用程序時web.config文件並不編譯進dll文件中。將來如果客戶端發生了變化,僅僅需要使用記事本打開Web.config文本編輯相關的設置就可以重新正常使用,而無需重新編譯程序。
1.配置文件的查找
我們先從配置文件的查找方式來了解配置文件。
.net提供了一個針對當前機器的配置文件,這個文件是machine.config,它位於%windir%Microsoft.NETFrameworkv2.0.50727CONFIG文件下。
(%windir%是系統分區下的系統目錄,在命令行模式下輸入%windir%然後回車就能查看當前機器的系統目錄,在Windows 2003以及Window XP中%windir%是系統分區下的windows目錄,在Windows 2000中%windir%是系統分區下的WinNT目錄)。這個文件裏面定義了針對當前及其的WinForm程序和Asp.net應用程序的配置。
machine.config在我的電腦的路徑是:C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config 由於裏面的內容比較多,而且看不懂,所以貼出來也沒有什麽用了。
在同樣的文件夾下還有一個web.config文件,這個文件包含了Asp.net網站的常用配置。Asp.net網站IIS啟動的時候會加載配置文件中的配置信息,然後緩存這些信息,這樣就不必每次去讀取配置信息。在運行過程中asp.net應用程序會監視配置文件的變化情況,一旦編輯了這些配置信息,就會重新讀取這些配置信息並緩存。
當我們要讀取某個節點或者節點組信息時,是按照以下方式搜索的:
(1)、如果在當前頁面所在的目錄下存在web.config文件,查看是否存在所要查找的節點名稱,如果存在返回結果並停止查找。
(2)、如果當前頁面所在目錄下不存在web.config文件或者web.config文件中不存在該節點名,則查找它的上級目錄,直到網站的根目錄。
(3)、如果網站根目錄下不存在web.config文件或者web.config文件中不存在該節點名則在 C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\webconfig.config文件中查找。
(4)如果在C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\webconfig.config文件中不存在響應的節點則在 C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config中查找。
(5)如果仍然沒有找到則返回null。
當前頁面所在目錄的web.config -> 上級目錄直至根目錄的web.config -> C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\webconfig.config -> C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\machine.config
所以如果我們對某個網站或者某個文件夾有特定要求的配置,可以在相應的文件夾下創建一個web.config文件,覆蓋掉上級文件夾中的web.config文件中的同名配置即可。這些配置信息的尋找只查找一次,所以便緩存起來供後來的調用。在asp.net應用程序運行過程中,如果web.config文件發生更改就會導致相應的應用程序重新啟動,這時存儲在服務器內存中的用戶會話信息就會丟失(如存儲在內存中的Session)。一些軟件(殺毒軟件)每次完成對web.config的訪問時就會修改web.config的訪問時間屬性,也會導致asp.net應用程序的重啟。
2、常見的配置節點及讀取
web.config文件是一個XML文件,它的根節點是<configuration>,在<configuration>節點下的常見子節點有:<configSections>、<appSettings>、<connectionStrings>和<system.web>。其中<appSettings>節點主要用於配置一些網站的應用配置信息,而<connectionStrings>節點主要用於配置網站的數據庫連接字符串信息。
<system.web>節點主要是網站運行時的一些配置,它的常見節點有下面這些:
<appSettings>節點
<appSettings>節點主要用來存儲Asp.net應用程序的一些配置信息,比如上傳文件的保存路徑等。
<appSettings> <!-- 允許上傳的圖片格式類型 --> <add key="ImageType" value=".jpg;.bmp;.gif;.png;.jpeg"> <!-- 允許上傳的文件類型 --> <add key="FileType" value=".jpg;.bmp;.gif;.png;.jpeg;.pdf;.zip;.rar;.xls;.doc"/> </appSettings>
<connectionStrings>節點
<connectionStrings>節點主要用於配置數據庫連接的,我們可以在<connectionStrings>節點中增加任意個節點來保存數據庫連接字符串,以後再代碼中通過代碼的方法動態獲取節點的值來實例化數據庫連接對象,這樣更改數據庫僅僅需要更改一下配置文件即可。
<connectionStrings> <!--SQL Server數據庫配置--> <add name="DBConnection" connectionString="Data Source=(local);Initial Catalog=AspNetStudy;User ID=sa;Password=123"/> </connectionStrings>
<compilation>節點
<compilation>節點配置ASP.NET使用的所有編譯設置,默認的debug屬性為"true",即允許調試,在這種情況下會影響網站的性能,所以在部署以後應該將該節點的值設置為false。
<authentication>節點
設置asp.net身份驗證模式,有四種身份驗證模式,取值如下:
Mode 說明
Windows 使用Windows身份驗證,適用於域用戶或者局域網用戶。
Forms 使用表單驗證,依靠網站開發人員進行身份驗證。
Passport 使用微軟提供的身份驗證服務進行身份驗證。
Node 不進行任何身份驗證
<customErrors>節點
<customErrors>節點用於定義一些錯誤信息的信息。此節點有Mode和defaultRedirect兩個屬性,其中defaultRedirect屬性是一個可選屬性,表示程序發生錯誤時重定向到的默認URL,如果沒有指定該屬性則顯示一般性錯誤。Mode屬性是一個必選屬性,它有三個可能值,他們所代表的意義分別如下:
Mode 說明
On 表示在本地和遠程用戶都會看到自定義錯誤信息。
Off 禁用自定義錯誤信息,本地和遠程用戶都會看到詳細的錯誤信息。
RemoteOnly 表示本地用戶將看到詳細錯誤信息,而遠程用戶將會看到自定義錯誤信息。
有必要說明一下本地用戶和遠程用戶的概念。當我們訪問Asp.net應用程序時所使用的機器和發布asp.net應用程序所使用的機器為同一臺機器時為本地用戶,否則就算為遠程用戶。在開發調試階段為了查找錯誤。Mode屬性建議設置為Off,而在部署階段應將Mode屬性設置為On或者RemoteOnly,以避免這些詳細的錯誤信息暴露了程序代碼細節從而引來黑客的入侵。
2013-04-16
今天同事在部署程序的時候,程序在本地測試正常,傳上服務器就出錯,但是不知道相信錯誤信息在哪裏被屏蔽了,當時就是設置這個地方傳上服務器後,相應的詳細錯誤信息就顯示了。
<customErrors mode="Off"></customErrors>
<error>子節點
在<customRrrors>節點下還包含有<error>子節點,這個節點主要是根據服務器的HTTP錯誤狀態代碼而重定向到我們自定義的錯誤頁面,註意要使<error>子節點下的配置生效,必須將<custonErrors>節點的Mode屬性設置為"On"。
<customErrorsmode="On"defaultRedirect="GenericErrorPage.htm"> <errorstatusCode="403"redirect="403.htm"/> <errorstatusCode="404"redirect="404.htm"/> </customErrors>
在上面的配置中如果用戶訪問的頁面不存在就會跳轉到404.htm頁面,如果用戶沒有權限訪問請求的頁面則會跳轉到403.htm頁面,403.htm和404.htm都是我們自己添加的頁面,我們可以再頁面中給出友好的錯誤提示。
<httpHandlers>節點
<httpHandlers>節點用於根據用戶請求的URL和HTTP謂詞將用戶的請求交給相應的處理程序。可以再配置級別的任何層次配置此節點,也就是說可以針對某個特定目錄下制定的特殊文件進行特殊處理。
下面是與machine.config文件同一目錄下的web.config文件中的<httpHandlers>節點配置:
<httpHandlers> <addpath="*.rules"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.xoml"verb="*"type="System.ServiceModel.Activation.HttpHandler,System.ServiceModel,Version=3.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"validate="false"/> <addpath="trace.axd"verb="*"type="System.Web.Handlers.TraceHandler"validate="true"/> <addpath="WebResource.axd"verb="GET"type="System.Web.Handlers.AssemblyResourceLoader"validate="true"/> <addpath="*.axd"verb="*"type="System.Web.HttpNotFoundHandler"validate="true"/> <addpath="*.aspx"verb="*"type="System.Web.UI.PageHandlerFactory"validate="true"/> <addpath="*.ashx"verb="*"type="System.Web.UI.SimpleHandlerFactory"validate="true"/> <addpath="*.asmx"verb="*"type="System.Web.Services.Protocols.WebServiceHandlerFactory,System.Web.Services,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a"validate="false"/> <addpath="*.rem"verb="*"type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory,System.Runtime.Remoting,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"validate="false"/> <addpath="*.soap"verb="*"type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory,System.Runtime.Remoting,Version=2.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"validate="false"/> <addpath="*.asax"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.ascx"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.master"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.skin"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.browser"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.sitemap"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.dll.config"verb="GET,HEAD"type="System.Web.StaticFileHandler"validate="true"/> <addpath="*.exe.config"verb="GET,HEAD"type="System.Web.StaticFileHandler"validate="true"/> <addpath="*.config"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.cs"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.csproj"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.vb"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.vbproj"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.webinfo"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.licx"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.resx"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.resources"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.mdb"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.vjsproj"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.java"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.jsl"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.ldb"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.ad"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.dd"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.ldd"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.sd"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.cd"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.adprototype"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.lddprototype"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.sdm"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.sdmDocument"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.mdf"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.ldf"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.exclude"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.refresh"verb="*"type="System.Web.HttpForbiddenHandler"validate="true"/> <addpath="*.svc"verb="*"type="System.ServiceModel.Activation.HttpHandler,System.ServiceModel,Version=3.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"validate="false"/> <addpath="*"verb="GET,HEAD,POST"type="System.Web.DefaultHttpHandler"validate="true"/> <addpath="*"verb="*"type="System.Web.HttpMethodNotAllowedHandler"validate="true"/> </httpHandlers>
從上面的配置中可以看出,針對*.mdf、*.ldf文件的Get或者Post請求都會交給System.Web.HttpForbiddenHandler來處理,處理的結果就是用戶不能查看或者下載相關的文件。如果我們某個文件夾下的文件或者某個類型的文件不允許用戶下載,可以在</httpHandlers>節點中增加相應的子節點。
<httpRuntime>節點
<httpRuntime>節點用於對ASP.NET HTTP運行庫設置。該節可以在計算機、站點、應用程序和子目錄級別聲明。
例如下面的配置控制用戶最大能上傳的文件為40M(40*1024k),最大超時時間為60秒,最大並發請求為100個。
<httpRuntime maxRequestLength="40960" executionTimeout="60" appRequestQueueLimie="100"/>
<pages>節點
<pages>節點用於表示對特定頁設置,主要有三個屬性,分別如下:
屬性名 說明
buffer 是否啟用了HTTP響應緩沖。
enableViewStateMac 是否應該對頁的視圖狀態運行計算機身份驗證檢查(MAC)
validateRequest 是否驗證用戶輸入中有跨站點腳本攻擊和SQL註入式漏洞攻擊,默認為true,如果出現匹配情況就會發生HttpRequestValidationException異常。對 於包含在線文本編輯器頁面一半自行驗證用戶輸入而將此屬性視為false。
<pagesbuffer="true"enableViewStateMac="true"validateRequest="false"/>
<sessionState>節點
<sessionState>節點用於配置當前asp.net應用程序的會話狀態配置。以下就是一個常見配置:
<sessionStatecookieless="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應用程序中的默認配置:
<globalizationfileEncoding="utf-8"requestEncoding="utf-8"responseEncoding="utf-8"/>
http://www.cnblogs.com/kissdodog/archive/2013/04/09/3009854.html
配置文件入門 - WebConfig.config常用配置節點介紹