程式師世界 >> 編程語言 >> .NET網頁編程 >> 關於.NET >> Web.config中注冊用戶控件和自定義控件

Web.config中注冊用戶控件和自定義控件

編輯：關於.NET

去年我一直把這個技巧包含在我的ASP.Net 技巧/訣竅講座裡，但倘若有這麼多人總是為它的存在而感到驚訝的話，我想值得用一個專屬的技巧/訣竅帖子來提高它的可見度。

問題：

在ASP.Net 的早先版本裡，開發人員通過在頁面的頂部添加 <%@ Register %> 指令來引入和使用自定義服務器控件和用戶控件時，象這樣：

<%@ Register TagPrefix="scott" TagName="header" Src="Controls/Header.ascx" %>
<%@ Register TagPrefix="scott" TagName="footer" Src="Controls/Footer.ascx" %>
<%@ Register TagPrefix="ControlVendor" Assembly="ControlVendor" %>

<Html>
<body>
    <form id="form1" runat="server">
        <scott:header ID="MyHeader" runat="server" />
    </form>
</body>
</Html>

注意到上面的前兩個注冊指令是用來注冊用戶控件的(是在.ascx文件裡實現的)，最後這個是用來注冊編譯進一個程序集 .dll 文件裡的自定義控件的。注冊完後，開發人員可以在頁面的任何地方用設定好的 tagprefix (標識前綴)和標識符號名( tagname)來聲明這些控件。

這行之有效，但管理起來會很痛苦，當你要在你的網站的許多頁面上使用控件的話，尤其是，假如你移動了.ascx 文件，需要更新所有的注冊聲明的話。

解決方案：

ASP.Net 2.0 使得控件聲明極其干淨而且管理起來極其容易。不用在你的頁面上重復這些聲明，只要在你的應用的web.config 文件的新的 pages->controls 部分聲明一次即可：

<?XML version="1.0"?>

<configuration>

  <system.web>

    <pages>
      <controls>
        <add tagPrefix="scottgu" src="~/Controls/Header.ascx" tagName="header"/>
        <add tagPrefix="scottgu" src="~/Controls/Footer.ascx" tagName="footer"/>
        <add tagPrefix="ControlVendor" assembly="ControlVendorAssembly"/>
      </controls>
    </pages>

  </system.web>

</configuration>

你可以用這種方式同時聲明用戶控件和編譯好的自定義控件。當你使用這個技巧時，Visual Studio是完全支持這兩者的，而且 VS 2005 Web Site 項目和 VS 2005 Web Application 項目也都支持這兩者。Visual Studio會在設計器裡以所見即所得(WYSIWYG)模式顯示這些控件，也會在後台編碼文件裡提示控件字段的聲明。

需要注意的是，上面用戶控件中“~”句法的使用。對那些不熟悉這個符號的人，ASP.Net中“~”符號意思是“從應用的根路徑來定位”，它提供了一個很好的方法來避免在你的編碼裡到處使用“..”。在web.config文件裡聲明用戶控件時，你總是應該使用它，因為頁面也許會使用在不同子目錄裡的控件，所以你應該總是始終如一地從應用的根路徑開始定位這些控件。

一旦你在web.config 文件中聲明好這些控件後，你就可以在你網站上的任何一個頁面，母板頁或者用戶控件中使用它們了，象這樣(不再需要注冊指令)：