在web應用程序運行時,對web.config文件的修改不需要重啟服務就可以生效(注:<processmodel> 節例外)。當然web.config文件是可以擴展的。你可以自定義新配置參數并編寫配置節處理程序以對它們進行處理。
web.config配置文件
web.config是個xml文件,所有配置信息都是以相應的節點來記錄的。配置文件以下所有的代碼都應該位下面的根節點中:
<configuration>
<system.web>
……
……
</system.web>
</configuration>
便于學習和節約篇幅,本書就省略了其他節點代碼,讀者可以從每個web應用程序的目錄下找到它,用文本編輯器就可以打開來看。下面我們就幾個重要的節點來介紹。
(1) <authentication> 節點
作用:配置 asp.net 身份驗證支持(為windows、forms、passport、none四種)。該元素只能在計算機、站點或應用程序級別聲明。<authentication> 元素必需與<authorization> 節配合使用。
(2) <authorization> 節點
作用:控制對 url 資源的客戶端訪問(如允許匿名用戶訪問)。此元素可以在任何級別(計算機、站點、應用程序、子目錄或頁)上聲明。必需與<authentication> 節配合使用。
(3) <compilation>節
作用:配置 asp.net 使用的所有編譯設置。默認的debug屬性為"true".在程序編譯完成交付使用之后應將其設為true(web.config文件中有詳細說明,此處省略示例)
(4) <customerrors>節點
作用:為 asp.net 應用程序提供有關自定義錯誤信息的信息。它不適用于 xml web services 中發生的錯誤。
例如:當發生錯誤時,將網頁跳轉到自定義的錯誤頁面。
<customerrors defaultredirect="errorpage.aspx" mode="remoteonly">
</customerrors>
其中元素defaultredirect表示自定義的錯誤網頁的名稱。mode元素表示:對不在本地 web 服務器上運行的用戶顯示自定義(友好的)信息。
(5)<httpruntime>節點
作用:配置 asp.net http 運行庫設置。該節可以在計算機、站點、應用程序和子目錄級別聲明。
例如:控制用戶上傳文件最大為4m,最長時間為60秒,最多請求數為100。
<httpruntime maxrequestlength="4096" executiontimeout="60" apprequestqueuelimit="100"/>
(6) <pages>節點
作用:標識特定于頁的配置設置(如是否啟用會話狀態、視圖狀態,是否檢測用戶的輸入等)。<pages>可以在計算機、站點、應用程序和子目錄級別聲明。
例如:不檢測用戶在瀏覽器輸入的內容中是否存在潛在的危險數據(注:該項默認是檢測,如果你使用了不檢測,一要對用戶的輸入進行編碼或驗證),在從客戶端回發頁時將檢查加密的視圖狀態,以驗證視圖狀態是否已在客戶端被篡改。(注:該項默認是不驗證)。
<pages buffer="true" enableviewstatemac="true" validaterequest="false"/>
(7)<sessionstate>節點
作用:為當前應用程序配置會話狀態設置(如設置是否啟用會話狀態,會話狀態保存位置)。
例如:
<sessionstate mode="inproc" cookieless="true" timeout="20"/>
</sessionstate>
需要說明的是:
mode="inproc"表示:在本地儲存會話狀態(你也可以選擇儲存在遠程服務器或sal服務器中或不啟用會話狀態);
cookieless="true"表示:如果用戶瀏覽器不支持cookie時啟用會話狀態(默認為false);
timeout="20"表示:會話可以處于空閑狀態的分鐘數;
(8)<trace>節點
作用:配置 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文件配置節過程分為兩步:
(一) 在配置文件頂部 <configsections> 和 </configsections>標記之間聲明配置節的名稱和處理該節中配置數據的 .net framework 類的名稱。
(二) 在 <configsections> 區域之后為聲明的節做實際的配置設置。
例如:創建一個節存儲數據庫連接字符串
<configuration>
<configsections>
<section name="appsettings" type="system.configuration.namevaluefilesectionhandler, system, version=1.0.3300.0, culture=neutral, publickeytoken=b77a5c561934e089"/>
</configsections>
<appsettings>
<add key="sqlcon" value="server=aspnet;database=northwind;uid=sa;pwd=1234567abc"/>
</appsettings>
<system.web>
......
</system.web>
</configuration>
訪問web.config文件的節點信息
可以通過使用configurationsettings.appsettings 靜態字符串集合來訪問 web.config 文件示例:獲取上面例子中建立的連接字符串。
dim sqlcon as string = configurationsettings.appsettings("sqlcon ")
dim sqlcon = new sqlconnection(sqlcon)
新聞熱點
疑難解答
圖片精選