共用方式為

HOW TO：在 ASP.NET Web 網頁中包含使用者控制項

  • 發行項

更新：2007 年 11 月

若要使用使用者控制項，請將使用者控制項包含在 ASP.NET Web 網頁中。當網頁收到要求且該網頁包含使用者控制項時，使用者控制項將會執行任何 ASP.NET 伺服器控制項執行的全部處理階段。如需這些處理階段的詳細資訊，請參閱 ASP.NET 網頁存留週期概觀。

若要在 Web Form 網頁中包含使用者控制項

  1. 在包含的 ASP.NET Web 網頁中，請建立包含下列項目的 @ Register 指示詞：

    • TagPrefix 屬性 (Attribute)，可以將前置詞與使用者控制項產生關聯。這個前置詞將包括在使用者控制項項目的開頭標記 (Tag) 中。

    • TagName 屬性，可以將名稱與使用者控制項產生關聯。這個名稱將包括在使用者控制項項目的開頭標記中。

    • Src 屬性，定義網頁所包含之使用者控制項檔案的虛擬路徑。

      注意事項：

      Src 屬性值可以是從應用程式根目錄，到使用者控制項原始程式檔的相對或絕對路徑。為了方便日後的調整，建議您使用相對路徑。波狀符號 (~) 字元表示應用程式的根目錄。使用者控制項不能放在 App_Code 目錄中。

  2. 在 Web 網頁主體的 form 項目中，宣告使用者控制項項目。

  3. 如果使用者控制項會公開公用屬性 (Property)，您也可以選擇以宣告方式設定屬性。

範例

下列程式碼範例，示範了包含使用者控制項的 ASP.NET Web 網頁。使用者控制項在 Controls 資料夾的 Spinner.ascx 檔中。在網頁中，控制項會註冊使用 uc 前置詞和 Spinner 標記名稱。這個範例將以宣告方式設定使用者控制項屬性 (Property) MinValue 和 MaxValue。

注意事項：

如需這個範例中所使用之使用者控制項程式碼的詳細資訊，請參閱 HOW TO：建立 ASP.NET 使用者控制項。

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

請參閱

概念

ASP.NET 使用者控制項概觀

建立自訂 ASP.NET 控制項架構藍圖