WebZone 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
做為在 Web 組件應用程式中當做伺服器控制項容器之所有控制項 (包括 Web 組件 Part 控制項、伺服器控制項和使用者控制項) 的基底類別。
public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
[<System.ComponentModel.Bindable(false)>]
type WebZone = class
inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
- 繼承
- 衍生
- 屬性
範例
下列程式碼範例示範 類別的使用 WebZone 。
程式碼範例的第一個部分會顯示衍生自 WebPart 類別的兩個自訂控制項。 若要執行程式碼範例,您必須編譯此原始程式碼。 您可以明確地編譯它,並將產生的元件放在網站的 Bin 資料夾或全域組件快取中。 或者,您也可以將原始程式碼放在月臺的 App_Code 資料夾中,在執行時間會動態編譯原始程式碼。 如需示範這兩種編譯方法的逐步解說,請參閱逐步解說 :開發和使用自訂 Web 服務器控制項。
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class CalendarWebPart : WebPart
{
Calendar _calendar;
public CalendarWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_calendar = new Calendar();
_calendar.Caption = "My Calendar";
this.Controls.Add(_calendar);
ChildControlsCreated = true;
}
}
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class LinksWebPart : WebPart
{
Literal _literal;
const string _literalText = @"
<table>
<tr>
<td><a href='http://msdn.microsoft.com'>MSDN</a></td>
</tr>
<tr>
<td><a href='http://msn.microsoft.com'>MSN</a></td>
</tr>
<tr>
<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
</tr>
</table>";
public LinksWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_literal = new Literal();
_literal.Text = _literalText;
this.Controls.Add(_literal);
ChildControlsCreated = true;
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class CalendarWebPart
Inherits WebPart
Private _calendar As Calendar
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_calendar = New Calendar()
_calendar.Caption = "My Calendar"
Me.Controls.Add(_calendar)
ChildControlsCreated = True
End Sub
End Class
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class LinksWebPart
Inherits WebPart
Private _literal As Literal
Private Const _literalText As String = _
"<table>" & _
"<tr>" & _
"<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
"</tr>" & _
"</table>"
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_literal = New Literal()
_literal.Text = _literalText
Me.Controls.Add(_literal)
ChildControlsCreated = True
End Sub
End Class
End Namespace
在程式碼範例的第二部分顯示的 Web 網頁主控WebPart控制項。 請注意,宣告式標記包含兩 WebPartZone 個控制項:一個 CatalogZone 控制項和一個 EditorZone 控制項。
<%@ page language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
您可以在瀏覽器中載入頁面,並在各種頁面顯示模式之間切換,以查看不同區域的行為。 如需顯示模式和讓使用者在它們之間切換的詳細資訊,請參閱 逐步解說:變更網頁元件頁面上的顯示模式。
備註
網頁元件區域是定義的區域,其中包含網頁的伺服器控制項,並提供一致的使用者介面 (UI) 、版面配置和轉譯自主控制項。 區域會在瀏覽器中轉譯為 HTML 資料表。
類別 WebZone 是所有 Web 元件區域的基類。 區域控制項是設計成包含其他控制項的複合控制項,因此類別 WebZone 繼承自 CompositeControl 類別。 與 WebPartManager 控制項和 Part 控制項 (或其他可放在區域) 的使用者或伺服器控制項一起,衍生自 WebZone 基類的區域控制項會形成 Web 元件應用程式的基本建置組塊。
網頁元件區域的重要角色是為其包含的控制項啟用完整的網頁元件功能。 每個網頁元件頁面至少包含一個區域,而區域可以包含零或多個元件控制項。 網頁元件功能需要區域。 如果沒有區域,即使是衍生自 類別的控制項,也可以有非常少的 WebPart Web 元件功能。 相反地,由於網頁元件控制項集的設計,您可以將一般 ASP.NET 控制項、伺服器控制項或使用者控制項 WebPartZoneBase 放在衍生自 WebZone) 的區域 (,而且由於位於區域中,這些一般伺服器控制項可以在執行時間做為 WebPart 控制項。 如需詳細資訊,請參閱 類別 GenericWebPart 的檔。
Web 元件控制項集中有兩個廣泛的區域類別,全部都繼承自基 WebZone 類。
WebPartZoneBase 區。 這些包含 WebPart (和其他伺服器和使用者) 控制項,並形成使用者大部分時間互動之網頁的主要 UI。
ToolZone 區。 這些區域提供網頁元件頁面的特殊檢視,可讓使用者修改 (個人化) 網頁元件頁面上包含 WebPartZoneBase 之控制項的內容、版面配置、外觀、行為和屬性。 例如,區域 CatalogZoneBase 是提供 ToolZone 頁面目錄檢視的 ,可讓使用者新增和移除伺服器控制項。 區域 EditorZoneBase 是另一種類型的 ToolZone ,可提供頁面的編輯檢視,讓使用者修改和編輯頁面的配置,以及控制項的屬性、外觀和行為。
網頁元件控制項集中的每個區域都是設計成包含衍生自 Part 類別的對應控制項類型,而元件控制項會做為區域的主要內容和主要 UI。 Web 元件控制項集中的區欄位型別,以及其所包含的元件控制項對應類型,如下表所示。
元件控制項類型 | 區域類型 |
---|---|
WebPart (和伺服器和使用者控制項,這些控制項會在執行時間包裝 GenericWebPart) | WebPartZone基類 () WebPartZoneBase |
EditorPart (有數個衍生控制項隨附于網頁元件控制項集,而且可以開發自訂 EditorPart 控制項) | EditorZone基類 () EditorZoneBase |
CatalogPart (有數個衍生控制項隨附于網頁元件控制項集,而且可以開發自訂 CatalogPart 控制項) | CatalogZone基類 () CatalogZoneBase |
WebPartConnection (連接控制項是唯一的,因為它們不是繼承自基類的元件控制項) | ConnectionsZone (直接繼承自 ToolZone ) |
Web 元件控制項中的所有區域都有其繼承自基 WebZone 類的基本通用使用者介面元素。 並非所有元素都會在每個區域上顯示,但每個區欄位型別都能夠擁有這些常見的區域相關 UI 元素,如下表所述。
區域區段 | 描述 |
---|---|
標頭 | 區域的頂端區段。 它包含標題文字,可以包含區域的標題;樣式屬性 (,例如區分標頭的框線或背景色彩) ;和區域層級動詞 (由按鈕、超連結或影像表示,) 使用者可以按一下以執行套用至整個區域的 UI 動作,例如關閉區域。 數 WebZone 個屬性,例如 HasHeader 、 HeaderStyle 和 HeaderText ,與區域標頭區域有關。 如果區域中有區域層級動詞, VerbButtonType 則 和 VerbStyle 屬性會套用至它們。 請注意,這兩個動詞屬性僅適用于區域層級動詞,不適用於區域中所包含的個別元件控制項中的動詞。 標頭不存在於每個區欄位型別中;通常它們會出現在 ToolZone 需要有具有文字和動詞的通用標頭區域的區域,例如關閉動詞。 |
主體 | 區域的主要內容區段。 衍生自 WebZone 的每個區域都有主體區段。 針對網頁元件控制項集中的所有區欄位型別,區域主體包含指定類型的 Part 控制項 (或其他伺服器控制項) 對應至區欄位型別,如上表所示。 類別的各種 WebZone 成員會影響本文區段的內容,例如 BackImageUrl 、 PartChromeStyle 、 PartChromeType 和 PartStyle 屬性。 如果本文區段是空的, EmptyZoneText 可以在某些情況下顯示訊息。 |
Chrome | 針對區域中每個元件控制項呈現的通用 UI 元素。 這與套用至區域本身的樣式屬性討論不同;chrome 特別適用于自主元件控制項。 Chrome 包含區域部分控制項的動詞、框線和其他樣式屬性,例如背景色彩或標題文字的字型樣式。 區域會使用適合 (其包含之元件控制項類型的單一 Chrome 物件來決定 Chrome 詳細資料,例如, CatalogPartChrome 包含 CatalogPart 控制項) 的 物件 CatalogZone 。 這個單一 Chrome 物件會處理區域中所有元件控制項的 Chrome 詳細資料和轉譯。 這可讓開發人員建立區域,讓他們可以指定所有元件控制項的一致、一般外觀和風格。 與區域元件控制項之 Chrome 相關的某些屬性包括 PartChromeStyle 、 PartChromeType 、 PartStyle 和 PartTitleStyle 屬性。 請注意,大部分的 Chrome 相關屬性,包括參考特定區欄位型別的 Chrome 物件的特定屬性,不會在基 WebZone 類中實作。 相反地,區域的大部分 Chrome 特定功能會根據其元件控制項的獨特需求,在特定區欄位型別上實作。 請參閱本主題上表所列每個區欄位型別的主題。 |
元件控制項 | 位於區域主體區段中的控制項。 繼承自 WebZone 類別的每個區域都會在其主體區段中包含對應型別的一或多個部分控制項,如本主題上表所示。 這些元件控制項會形成 Web 元件應用程式的主要 UI。 衍生自 WebZone 的大部分區欄位型別都有集合屬性,可讓它們參考其包含的所有元件控制項,例如 WebParts 類別上的 WebPartZoneBase 屬性,以及 EditorParts 類別上的 EditorZoneBase 屬性。 |
頁尾 | 區域的底部區段。 就像標頭區段一樣,它不存在於每種區欄位型別中,但通常會發生在 ToolZone 區域中。 頁尾區段的一般內容是動詞,例如確定動詞或套用動詞,出現在區域的頁尾 EditorZoneBase 。 與頁尾區段相關的某些屬性包括 HasFooter 、 FooterStyle 、 VerbButtonType 和 VerbStyle 屬性。 |
上述表格會討論大部分 WebZone 類別的屬性,這些屬性描述區域的通用 UI 元素。 類別 WebZone 也有數個與其轉譯內容角色相關的方法。 RenderBody您可以覆寫 、 RenderContents 、 RenderFooter 和 RenderHeader 方法,以程式設計方式控制區域的每個特定區段的轉譯。 例如,如果您想要自訂應用程式中目錄區域的所有頁尾區段轉譯,您可以繼承自 CatalogZoneBase 類別、覆寫 RenderFooter 繼承自 WebZone 的方法,以及變更頁尾區段的轉譯。
給實施者的注意事項
您很少需要直接從 WebZone 類別繼承,才能開發自訂 Web 元件區域。 Web 元件控制項集包含上述一節中所列的特殊區域,而且通常您可以從其中一個衍生,將自訂行為新增至區域。 如果您決定直接繼承自 WebZone 類別,則必須覆寫數個屬性和方法, (請參閱類別成員 WebZone 的檔) 。 您也必須建立自訂 WebPartManager 控制項,選擇性地建立自訂 WebPartDisplayMode 控制項,以建立唯一的顯示模式,以檢視您的區域,以及其他自訂專案,讓您的區域在網頁元件控制項集內運作。
屬性
AccessKey |
取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
BackImageUrl |
取得或設定區域背景影像的 URL。 |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
ChildControlsCreated |
取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
ClientIDSeparator |
取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
Controls |
取得表示 ControlCollection 中之子控制項的 CompositeControl 物件。 (繼承來源 CompositeControl) |
ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
ControlStyleCreated |
取得值,指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 WebControl) |
DataItemContainer |
如果命名容器實作 IDataItemContainer,則取得命名容器的參考。 (繼承來源 Control) |
DataKeysContainer |
如果命名容器實作 IDataKeysControl,則取得命名容器的參考。 (繼承來源 Control) |
DesignMode |
取得值,指出控制項是否正用於設計介面上。 (繼承來源 Control) |
EmptyZoneText |
取得或設定區域不包含控制項時出現的訊息。 |
EmptyZoneTextStyle |
取得空區域中替代符號文字的樣式屬性。 |
Enabled |
取得或設定值,指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
ErrorStyle |
取得呈現錯誤訊息的樣式屬性,無法載入或建立 WebPart 控制項時會顯示該錯誤訊息。 |
Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
Font |
取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 WebControl) |
FooterStyle |
取得區域頁尾區內容的樣式屬性。 |
ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
HasAttributes |
取得值,指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
HasChildViewState |
取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
HasFooter |
取得值,表示區域是否具有頁尾區。 |
HasHeader |
取得值,表示區域是否具有頁首區。 |
HeaderStyle |
取得區域頁首區內容的樣式屬性。 |
HeaderText |
取得或設定區域的頁首區域文字。 |
Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
IsChildControlStateCleared |
取得值,指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
IsEnabled |
取得值,指出是否啟用控制項。 (繼承來源 WebControl) |
IsTrackingViewState |
取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
IsViewStateEnabled |
取得值,指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
LoadViewStateByID |
取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
NamingContainer |
取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
Padding |
取得或設定表格的儲存格填補屬性,該表格包含區域的 WebPart 控制項。 |
Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
PartChromePadding |
取得或設定 WebPart 控制項的內容與此控制項的框線之間的距離。 |
PartChromeStyle |
取得樣式特性,該樣式特性套用至區域中 Web 組件控制項的框線。 |
PartChromeType |
取得或設定區域中架構 Web 組件控制項的框線類型。 |
PartStyle |
取得樣式特性,該樣式特性套用至區域中每個 Web 組件控制項的框線和內容。 |
PartTitleStyle |
取得區域中每個 Web 組件控制項標題列內容的樣式屬性。 |
RenderClientScript |
取得值,指出是否在 Web 組件頁面上呈現用戶端指令碼。 |
RenderingCompatibility |
取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
Site |
當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
Style |
取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
SupportsDisabledAttribute |
取得值,這個值表示當控制項的 |
TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 |
TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
ValidateRequestMode |
取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
VerbButtonType |
取得或設定用於表示區域動詞命令的按鈕類型。 |
VerbStyle |
取得使用者介面 (UI) 動詞命令的樣式屬性,該動詞命令與區域中的 Web 組件控制項相關聯。 |
ViewState |
取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
ViewStateIgnoresCase |
取得值,指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
Visible |
取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
WebPartManager |
取得 WebPartManager 控制項的參考,該控制項與 Web 組件頁面上的 WebZone 控制項執行個體相關聯。 |
Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
方法
事件
DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
Disposed |
發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
Init |
發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。 (繼承來源 Control) |
Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
GetDefaultValues(INamingContainer) |
取得所指定資料控制項的預設值集合。 |
GetMetaTable(INamingContainer) |
取得所指定資料控制項中的資料表中繼資料。 |
SetMetaTable(INamingContainer, MetaTable) |
設定所指定資料控制項中的資料表中繼資料。 |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
設定所指定資料控制項的資料表中繼資料及預設值對應。 |
SetMetaTable(INamingContainer, MetaTable, Object) |
設定所指定資料控制項的資料表中繼資料及預設值對應。 |
TryGetMetaTable(INamingContainer, MetaTable) |
判斷資料表中繼資料是否可供使用。 |
EnableDynamicData(INamingContainer, Type) |
針對指定的資料控制項啟用動態資料行為。 |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
針對指定的資料控制項啟用動態資料行為。 |
EnableDynamicData(INamingContainer, Type, Object) |
針對指定的資料控制項啟用動態資料行為。 |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應