首頁  >  文章  >  後端開發  >  詳解ASP.NET設定檔Web.config

詳解ASP.NET設定檔Web.config

高洛峰
高洛峰原創
2017-01-13 13:40:361268瀏覽

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

詳解ASP.NET設定檔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文件配置节过程分为两步。

一是在在配置文件顶部 标记之间声明配置节的名称和处理该节中配置数据的 .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 文件示例:获取上面例子中建立的连接字符串。

四、创建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中文网!

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn