共用方式為

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

  • 發行項

使用者控制項只會在它們包含於 Web Form 網頁時運作。當網頁要求抵達而那網頁含有使用者控制項時，使用者控制項將會經歷任何 ASP.NET 伺服器控制項所屬的全部處理階段。如需這些處理階段的詳細資訊，請參閱 Web Form 網頁處理。

在 Web Form 網頁中包含使用者控制項很簡單。

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

  1. 在包含 Web Form 網頁中，宣告 @ Register 指示詞，包括：

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

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

    • Src 屬性，定義您將於 Web Form 網頁中包含之使用者控制項檔案的虛擬路徑。

      ****注意   Src 屬性值可能是從應用程式根目錄到使用者控制項的原始程式檔之相對或絕對路徑。為了使用上的簡便，建議您使用相對路徑。波狀符號 (~) 字元表示應用程式的根目錄。

    例如，下列程式碼註冊定義於檔案 Login1.ascx 中的使用者控制項。它已經被賦予標記前置詞 Acme 和標記名稱 Login。檔案位於 Controls 目錄中。

    <%@ Register TagPrefix="Acme" TagName="Login" Src="~\controls\login1.ascx" %>

  2. 使用自訂伺服器控制項語法，在 HtmlForm 伺服器控制項的開始和結束標記 (<form runat=server></form>) 之間宣告使用者控制項項目。例如，若要宣告前面步驟中匯入的控制項，請使用下列語法。

    <html>
<body>
<form runat="server">
<Acme:Login id="MyLogin" runat="server"/>
</form>
</body>
</html>

    **注意   **不論有多少 ASP.NET 伺服器控制項 (使用者控制項和任何其他控制項) 包含於您的 Web Form 網頁，您應該只包含一個 HtmlForm 伺服器控制項在 Web Form 網頁上。將所有伺服器控制項包含在這個控制項的開頭和結束標記之間。

請參閱

Web Form 使用者控制項 | 建立使用者控制項 | Web Form 網頁中的伺服器事件處理 | 處理使用者控制項事件