PlaceHolder 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在網頁上儲存動態新增的伺服器控制件。
public ref class PlaceHolder : System::Web::UI::Controlpublic class PlaceHolder : System.Web.UI.Controltype PlaceHolder = class
inherit ControlPublic Class PlaceHolder
Inherits Control- 繼承
範例
下列程式代碼範例示範如何將控件動態新增至 PlaceHolder 控件。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>PlaceHolder Example</title>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
HtmlButton myButton = new HtmlButton();
myButton.InnerText = "Button 1";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 2";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 3";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 4";
PlaceHolder1.Controls.Add(myButton);
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>PlaceHolder Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>PlaceHolder Example</title>
<script runat="server">
Sub Page_Load(Sender As Object, e As EventArgs)
Dim myButton As HtmlButton = New HtmlButton()
myButton.InnerText = "Button 1"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 2"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 3"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 4"
PlaceHolder1.Controls.Add(myButton)
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>PlaceHolder Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server"/>
</form>
</body>
</html>
備註
在本主題中：
介紹
使用 PlaceHolder 控件做為容器來儲存動態新增至網頁的伺服器控制件。 PlaceHolder 控件不會產生任何可見的輸出，而且只會當做網頁上其他控件的容器使用。 您可以使用 Control.Controls 集合，在 PlaceHolder 控件中新增、插入或移除控件。
宣告式語法
<asp:PlaceHolder
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Visible="True|False"
/>
建構函式
| PlaceHolder() |
初始化 PlaceHolder 類別的新實例。 |
屬性
| Adapter |
取得控制器特定配接器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含這個控制項之 Page 或 UserControl 物件的應用程式相對虛擬目錄。 (繼承來源 Control) |
| BindingContainer |
取得包含此控件數據系結的 控件。 (繼承來源 Control) |
| ChildControlsCreated |
取得值，這個值表示是否已建立伺服器控制件的子控件。 (繼承來源 Control) |
| ClientID |
取得由 ASP.NET 產生的 HTML 標記控件識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示 ClientID 屬性中使用的分隔符。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求之伺服器控制項相關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，代表UI階層中指定之伺服器控件的子控件。 (繼承來源 Control) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DesignMode |
取得值，指出控件是否在設計介面上使用。 (繼承來源 Control) |
| EnableTheming |
取得或設定值，指出主題是否套用至這個控件。 |
| EnableTheming |
取得或設定值，指出主題是否套用至這個控件。 (繼承來源 Control) |
| EnableViewState |
取得或設定值，指出伺服器控制項是否將檢視狀態及其包含之任何子控件的檢視狀態保存至要求用戶端。 (繼承來源 Control) |
| Events |
取得控制項的事件處理程式委派清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| HasChildViewState |
取得值，指出目前伺服器控件的子控件是否有任何儲存的檢視狀態設定。 (繼承來源 Control) |
| ID |
取得或設定指派給伺服器控制件的程式設計標識碼。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控件識別碼的字元。 (繼承來源 Control) |
| IsChildControlStateCleared |
取得值，指出這個控件中包含的控件是否具有控件狀態。 (繼承來源 Control) |
| IsTrackingViewState |
取得值，這個值表示伺服器控件是否將變更儲存至其檢視狀態。 (繼承來源 Control) |
| IsViewStateEnabled |
取得值，指出這個控件是否啟用檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
取得值，指出控件是否參與藉由 ID 而不是索引載入其檢視狀態。 (繼承來源 Control) |
| NamingContainer |
取得伺服器控制項命名容器的參考，這個容器會建立唯一的命名空間，以區分具有相同 ID 屬性值的伺服器控制件。 (繼承來源 Control) |
| Page |
取得包含伺服器控制件之 Page 實例的參考。 (繼承來源 Control) |
| Parent |
取得頁面控件階層中伺服器控制件之父控件的參考。 (繼承來源 Control) |
| RenderingCompatibility |
取得值，指定轉譯 HTML 與 的 ASP.NET 版本相容。 (繼承來源 Control) |
| Site |
取得在設計介面上呈現時裝載目前控制件之容器的相關信息。 (繼承來源 Control) |
| SkinID |
取得或設定要套用至控件的面板。 (繼承來源 Control) |
| TemplateControl |
取得或設定包含這個控件之範本的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制件之 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| UniqueID |
取得伺服器控制件的唯一階層式限定標識碼。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定值，這個值表示控件是否會檢查瀏覽器的用戶端輸入是否有潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，可讓您跨相同頁面的多個要求儲存和還原伺服器控件的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，這個值表示 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控件的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，這個值表示伺服器控制項是否呈現為頁面上的UI。 (繼承來源 Control) |
方法
事件
| DataBinding |
當伺服器控制項系結至數據源時發生。 (繼承來源 Control) |
| Disposed |
發生於從記憶體釋放伺服器控制項時，這是要求 ASP.NET 頁面時伺服器控件生命週期的最後階段。 (繼承來源 Control) |
| Init |
當伺服器控件初始化時發生，這是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
當伺服器控制項載入至 Page 物件時發生。 (繼承來源 Control) |
| PreRender |
發生在載入 Control 物件之後，但在轉譯之前發生。 (繼承來源 Control) |
| Unload |
發生於伺服器控制件從記憶體卸除時。 (繼承來源 Control) |
明確介面實作
| IControlBuilderAccessor.ControlBuilder |
如需此成員的描述，請參閱 ControlBuilder。 (繼承來源 Control) |
| IControlDesignerAccessor.GetDesignModeState() |
如需此成員的描述，請參閱 GetDesignModeState()。 (繼承來源 Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
如需此成員的描述，請參閱 SetDesignModeState(IDictionary)。 (繼承來源 Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
如需此成員的描述，請參閱 SetOwnerControl(Control)。 (繼承來源 Control) |
| IControlDesignerAccessor.UserData |
如需此成員的描述，請參閱 UserData。 (繼承來源 Control) |
| IDataBindingsAccessor.DataBindings |
如需此成員的描述，請參閱 DataBindings。 (繼承來源 Control) |
| IDataBindingsAccessor.HasDataBindings |
如需此成員的描述，請參閱 HasDataBindings。 (繼承來源 Control) |
| IExpressionsAccessor.Expressions |
如需此成員的描述，請參閱 Expressions。 (繼承來源 Control) |
| IExpressionsAccessor.HasExpressions |
如需此成員的描述，請參閱 HasExpressions。 (繼承來源 Control) |
| IParserAccessor.AddParsedSubObject(Object) |
如需此成員的描述，請參閱 AddParsedSubObject(Object)。 (繼承來源 Control) |
擴充方法
| FindDataSourceControl(Control) |
傳回與指定控件之數據控件相關聯的數據源。 |
| FindFieldTemplate(Control, String) |
傳回指定控件命名容器中指定數據行的欄位範本。 |
| FindMetaTable(Control) |
傳回包含數據控制件的中繼資料表物件。 |
