首頁 >後端開發 >C#.Net教程 >ASP.NET Web.config設定檔詳解

ASP.NET Web.config設定檔詳解

高洛峰
高洛峰原創
2017-01-13 13:49:581715瀏覽

分析:

      .NET Web 應用程式的設定資訊(如最常用的設定ASP.Net Web 應用程式的驗證方式),它可以出現在應用程式的每個目錄中。當你透過VB.NET新 建立 一個Web應用程式後,預設會在根目錄自動建立一個預設的Web.config文件,包括預設的設定設置,所有的子目錄都繼承它的設定設定。如果你想修改子目錄的設定設置, 你可以 在該子目錄下新建一個 Web.config檔。它可以提供從父目錄繼承的配置資訊以外的配置信息,也可以重寫或修改父目錄中定義的設定。
      執行時對Web.config檔的修 改不需要重新啟動服務就可以生效(註: 節例外)。當然Web.config檔是可以擴充的。你可以自訂新配置參數並編寫配置節處理程序以對它們進行處理。

一、web.config設定檔(預設的設定)

以下所有的程式碼都應該位於如下程式碼之間,為了更簡潔,以下的範例都省略了這段XML標記。

< configuration>
  < system.web>
  < /system.web>
< /configuration>

1、 節 

       作用:設定 ASP.NET 驗證支援(為Windows、Forms、PassPort、四種四種)。 該元素只能在電腦、網站或應用程式層級聲明。 元素必需與    節搭配使用。

      eg:  以下範例為基於窗體(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 。

httpRun>🜎 :標識特定於頁的設定設定(如是否啟用會話狀態、視圖狀態,是否偵測使用者的輸入等)。 可以在電腦、網站、應用程式和子目錄層級聲明。
 範例:不偵測使用者在瀏覽器輸入的內容中是否存在潛在的危險資料(註:該項預設是偵測,如果你使用了不偵測,一要對使用者的輸入進行編碼或驗證),在從客戶端回發頁時將檢查加密的視圖狀態,以驗證視圖狀態是否已在客戶端被竄改。 (註:此項預設為不驗證)


7、

 狀態設定(如設定是否啟用會話狀態,會話狀態儲存位置)。
 範例:

< sessionState mode="InProc" cookieless="true" timeout="20"/>
< /sessionState>

 注:
 mode="InProc"表示:在本地储存会话状态(你也可以选择储存在远程服务器或SAL服务器中或不启用会话状态)
 cookieless="true"表示:如果用户浏览器不支持Cookie时启用会话状态(默认为False)
 timeout="20"表示:会话可以处于空闲状态的分钟数

 8、aaee0798d61f0c1688dd8c23d7e1cc45 

 作用:配置 ASP.NET 跟踪服务,主要用来程序测试判断哪里出错。
 示例:以下为Web.config中的默认配置:

ee811ff3d61828767fb5c6ffab003cce

注:
 enabled="false"表示不启用跟踪;requestLimit="10"表示指定在服务器上存储的跟踪请求的数目
 pageOutput="false"表示只能通过跟踪实用工具访问跟踪输出;
 traceMode="SortByTime"表示以处理跟踪的顺序来显示跟踪信息;
 localOnly="true" 表示跟踪查看器 (trace.axd) 只用于宿主 Web 服务器;

9、1dcc4c920d99d48189de261dfba48f61

<system.webServer>
  <security>
   <requestFiltering>
    <requestLimits maxAllowedContentLength="2147483648"/>
   </requestFiltering>
  </security>
</system.webServer>

二、自定义Web.config文件配置节 
自定义Web.config文件配置节过程分为两步。

一是在在配置文件顶部 f0c345cb8609a7447fbc7220c375eedc 和 107179cec9ad9ec61c47a52cad36d19f标记之间声明配置节的名称和处理该节中配置数据的 .NET Framework 类的名称。

二是在 f0c345cb8609a7447fbc7220c375eedc 区域之后为声明的节做实际的配置设置。

示例:创建一个节存储数据库连接字符串

< 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\725e7c8a0cf2bfbdc143d67566e91876\CONFIG 目录下的 Machine.config 和 Web.config 文件继承所有配置设置,但在此处看不到这些默认设置。如果要重写继承的默认设置或添加 httpHandlers 元素(ASP.NET 设置架构) 等集合元素,则只需创建应用程序级别和目录级别的 Web.config 文件。

若要查看当前应用程序的所有配置设置,可以运行主题如何:以编程方式查看继承的配置设置和本地配置设置中包含的代码。也可以查看 %SystemRoot%\Microsoft.NET\Framework\725e7c8a0cf2bfbdc143d67566e91876\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配置文件详解相关文章请关注PHP中文网!

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