Web.config檔案是一個XML文字文件,它用來儲存ASP.NET Web 應用程式的設定資訊(如最常用的設定ASP.NET Web 應用程式的驗證方式),它可以出現在應用程式的每一個目錄中。當你透過VB.NET新建一個Web應用程式後,預設會在根目錄自動建立一個預設的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文件配置节过程分为两步。
一是在在配置文件顶部
二是在
示例:创建一个节存储数据库连接字符串
<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中文网!