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 是所有網頁元件區域的基類。 區域控制項是設計來包含其他控制件的複合控制項,因此類別 WebZone 繼承自 CompositeControl 類別。 除了 WebPartManager 控件和 Part 控件 (或其他可以放在區域) 的使用者或伺服器控件之外,衍生自 WebZone 基類的區域控制元件形成 Web 元件應用程式的基本建置元件。
網頁元件區域的重要角色是為其包含的控制件啟用完整的網頁元件功能。 每個網頁元件頁面至少包含一個區域,而區域可以包含零或多個元件控件。 網頁元件功能需要區域。 如果沒有區域,即使是衍生自 類別的 WebPart 控件,也可以有非常少的網頁元件功能。 相反地,由於網頁元件控件集的設計,您可以將一般 ASP.NET 控件、伺服器控件或使用者控件放在 WebPartZoneBase 衍生自 WebZone) 的區域 (,而且由於位於區域中,這些一般伺服器控件可以在運行時間做為 WebPart 控件。 如需詳細資訊,請參閱 類別的檔 GenericWebPart 。
Web 元件控制項集中有兩個廣泛的區域類別,全部都是繼承自基 WebZone 類。
WebPartZoneBase 區。 這些包含 WebPart (和其他伺服器和使用者) 控件,並形成使用者與大部分時間互動之網頁的主要UI。
ToolZone 區。 這些區域提供網頁元件頁面的特殊檢視,可讓使用者修改 (個人化) 網頁元件頁面上區域所包含的 WebPartZoneBase 控件內容、配置、外觀、行為和屬性。 例如, CatalogZoneBase 區域是提供 ToolZone 頁面目錄檢視的 ,可讓使用者新增和移除伺服器控制件。 EditorZoneBase區域是另一種類型的 ,ToolZone可提供頁面的編輯檢視,讓使用者修改和編輯頁面的配置,以及控件的屬性、外觀和行為。
Web 元件控制項集中的每個區域都是設計來包含衍生自 Part 類別的對應控件類型,而元件控制項會做為區域的主要內容和主要 UI。 下表顯示 Web 元件控制項集中的區域類型,以及其所包含的對應元件控制項類型。
元件控制項類型 | 區域類型 |
---|---|
WebPart (和伺服器和使用者控件,這些控制項會在運行時間以 GenericWebPart 包裝) | WebPartZone (基類已 WebPartZoneBase ) |
EditorPart (數個衍生控件隨附於 Web 元件控制件集,而且可以開發自定義 EditorPart 控件) | EditorZone (基類已 EditorZoneBase ) |
CatalogPart (數個衍生控件隨附於 Web 元件控制件集,而且可以開發自定義 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 包含區域部分控件的動詞、框線和其他樣式屬性,例如背景色彩或標題文字的字型樣式。 區域會使用適合 (其元件控制項類型的單一 CatalogPartChrome Chrome 物件來決定 chrome 詳細數據,例如,包含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) |
針對指定的資料控制項啟用動態資料行為。 |