Part 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
作為所有 Web 組件組件控制項的基底類別,來轉譯 Web Form 網頁上的模組化使用者介面。
public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor
public abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor
type Part = class
inherit Panel
interface INamingContainer
interface ICompositeControlDesignerAccessor
Public MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer
- 繼承
- 衍生
- 實作
範例
下列程式代碼範例示範宣告式使用 類別的 Part 數個屬性,方法是使用 ASP.NET 網頁中所參考之自定義 WebPart 控件的兩個實例。 若要執行程式碼範例,您必須編譯此原始程式碼。 您可以明確地編譯它,並將產生的元件放在網站的 Bin 資料夾或全域程式集緩存中。 或者,您可以將原始程式碼放在月臺的 App_Code資料夾中,其將在運行時間動態編譯。 如需示範這兩種編譯方法的逐步解說,請參閱逐步解說 :開發和使用自定義 Web 伺服器控制件。
範例的第一個部分包含自定義控件的程式代碼,名為 TextDisplayWebPart
。 因為控件衍生自 WebPart,它也會繼承 類別所提供的通用屬性 Part ,並說明在此程式代碼範例中使用這些屬性。
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 TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
const string _subTitle = "Contoso, Ltd";
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[
Personalizable(PersonalizationScope.User, true),
WebBrowsable()
]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
// Clear the input textbox.
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
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 TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
' Clear the input textbox.
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
範例的第二個部分示範如何參考 ASP.NET 網頁中的自定義元件控件。 請注意,各種 Part 屬性會以宣告方式指派給自定義控件實例。 比較參考頁面上兩個實例的宣告式程式代碼,然後在瀏覽器中載入頁面。 請注意各種屬性如何影響控件的外觀。 例如,在瀏覽器中載入頁面之後,控制件的第二個實例會顯示最小化,因為它ChromeState的 TextDisplayWebPart
屬性值設定為 Minimized。
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!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 id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!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 id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
備註
類別 Part 會定義所有元件控制項通用的屬性,並讓他們在網頁上具有模組化且一致的外觀。 這些通用屬性包括標題、描述,以及圍繞元件控件之 Chrome 或框架的特性。
屬性 Title 會指定元件控制件的標題。 屬性 Description 是用來摘要元件控件的目的,並顯示為控件標題列中的工具提示。 屬性 ChromeType 會指定在元件控件周圍轉譯的框線類型,而 ChromeState 屬性會指出元件控件是正常轉譯還是最小化。 元件控制元件的框線會受到包含該控制件的區域屬性所影響;例如, PartChromeType 屬性會影響區域中包含的所有元件控件框架。
元件控制件的其中一種類型是 WebPart 控制項,它會轉譯對應區域內的內容。 另一種類型是 EditorPart 控件,提供使用者介面 (UI) 控件,用來修改 (個人化) 個別 WebPart 控件。 第三種類型的元件控制項是 CatalogPart 控制項,提供使用者可以新增或移除網頁的 WebPart 控件清單。
部分控件包含在區域中,這些控件全都衍生自抽象 WebZone 類。 區域負責組織它所包含的元件控制件。 每個區域也會轉譯本身的UI元素,包括頁首、頁尾、標題欄,以及每個包含元件控件周圍的UI元素,例如框線。
注意
雖然元件控制項通常位於區域中,但如果在網頁的標記中以宣告方式參考控件,就可以將元件控制件放在區域外部。 如果元件控件在網頁上的區域之外宣告,控件仍可運作,但會失去大部分的網頁元件功能。 例如,無法編輯控件,而且無法在運行時間拖曳到區域。 請記住,在運行時間,無法從區域拖曳任何元件控件,並將它放到區域外部的頁面。
下表顯示基底元件類型的一些範例及其對應的區域類型。
元件控制項類型 | 區域類型 |
---|---|
WebPart | WebPartZone |
EditorPart | EditorZone |
CatalogPart | CatalogZone |
衍生自 Part 類別的各種元件控制項會以不同的方式處理繼承的UI導向屬性。
WebPart 控件會覆寫數個繼承的 UI 屬性,並以屬性 (標記 Personalizable
它們以取得詳細數據,請參閱 PersonalizableAttribute 類別檔) ,這可讓這些屬性的值儲存在未來的瀏覽器會話中,這是稱為個人化的功能。 例如,如果您以程序設計方式讓使用者在運行時間更新 WebPart 控件 Title 的 屬性值,該值將會 (假設已啟用個人化,這是預設) 。 控件繼承自 Part 類別和 類別的WebControl數個UI屬性WebPart會以相同方式處理。
相反地,其他部分控件,例如 EditorPart 和 CatalogPart,則不會讓繼承的UI屬性個人化。 基於這個理由,未來瀏覽器會話不會儲存以程序設計方式指派的屬性值。 例如,如果您以程序設計方式讓使用者在運行時間更新 PropertyGridEditorPart 控件的 Title 屬性,更新的值會在控件關閉或瀏覽器會話結束時遺失。
將值儲存在這類繼承的UI屬性上 EditorPart ,以及 CatalogPart 未來瀏覽器會話之控件的簡單方式,就是以頁面持續性格式宣告屬性值。 不過,這是靜態方法,仍然不允許用戶個人化屬性值。 或者,如果您想要啟用繼承UI屬性的程式設計更新,讓使用者可以在運行時間個人化它們,您可以使用私用的靜態變數來儲存屬性值。 例如,每當 (建立或 CatalogPart 控件的新實例EditorPart時,在處理控件Init事件) 的方法中,您可以將靜態變數的值重新指派給對應的屬性。 這種方法可讓用戶個人化 Web 元件應用程式的編輯 UI 和目錄 UI。
給實施者的注意事項
一般而言,您不應該直接從 Part 類別繼承來開發自定義 Web 元件控制件。 若要提供完整的網頁元件功能,網頁元件控件集需要衍生自 Part 類別的類別,也就是 WebPart、 EditorPart和 CatalogPart,因此您應該衍生自這些類別來開發自定義控件。 不過,瞭解基 Part 類的行為仍然很重要,因為它提供所有其他元件類別所使用的一組通用屬性。
屬性
AccessKey |
取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
BackImageUrl |
取得或設定面板控制項背景影像的 URL。 (繼承來源 Panel) |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
ChildControlsCreated |
取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
ChromeState |
取得或設定組件控制項是否為最小化或一般狀態。 |
ChromeType |
取得或設定圍繞著 Web 組件控制項的框線類型。 |
ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
ClientIDSeparator |
取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
Controls |
取得 ControlCollection 物件,其包含使用者介面階層架構中所指定伺服器控制項的子控制項。 |
ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
ControlStyleCreated |
取得值,指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 WebControl) |
DataItemContainer |
如果命名容器實作 IDataItemContainer,則取得命名容器的參考。 (繼承來源 Control) |
DataKeysContainer |
如果命名容器實作 IDataKeysControl,則取得命名容器的參考。 (繼承來源 Control) |
DefaultButton |
取得或設定 Panel 控制項中包含之預設按鈕的識別項。 (繼承來源 Panel) |
Description |
取得或設定摘要說明組件控制項功能的簡短片語,用於組件控制項的工具提示和資料目錄。 |
DesignMode |
取得值,指出控制項是否正用於設計介面上。 (繼承來源 Control) |
Direction |
取得或設定包含文字之控制項在 Panel 控制項中的顯示方向。 (繼承來源 Panel) |
Enabled |
取得或設定值,指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
Font |
取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 WebControl) |
ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
GroupingText |
取得或設定面板控制項中包含之控制項群組的標題。 (繼承來源 Panel) |
HasAttributes |
取得值,指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
HasChildViewState |
取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
HorizontalAlign |
取得或設定在面板中內容的水平對齊。 (繼承來源 Panel) |
ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
IsChildControlStateCleared |
取得值,指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
IsEnabled |
取得值,指出是否啟用控制項。 (繼承來源 WebControl) |
IsTrackingViewState |
取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
IsViewStateEnabled |
取得值,指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
LoadViewStateByID |
取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
NamingContainer |
取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
RenderingCompatibility |
取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
ScrollBars |
取得或設定在 Panel 控制項中捲軸的可視性和位置。 (繼承來源 Panel) |
Site |
當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
Style |
取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
SupportsDisabledAttribute |
取得值,這個值表示當控制項的 |
TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
Title |
取得或設定組件控制項標題。 |
ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
ValidateRequestMode |
取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
ViewState |
取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
ViewStateIgnoresCase |
取得值,指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
Visible |
取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
Wrap |
取得或設定值,指示面板中的內容是否換行。 (繼承來源 Panel) |
方法
AddAttributesToRender(HtmlTextWriter) |
將背景影像、對齊方式、換行和方向的相關資訊加入要呈現的屬性清單中。 (繼承來源 Panel) |
AddedControl(Control, Int32) |
在子控制項加入 Control 物件的 Controls 集合後呼叫。 (繼承來源 Control) |
AddParsedSubObject(Object) |
通知伺服器控制項,XML 或 HTML 項目已剖析,並將項目加入伺服器控制項的 ControlCollection 物件中。 (繼承來源 Control) |
ApplyStyle(Style) |
將指定樣式的任何非空白項目加入到 Web 控制項中,覆寫控制項的任何現有的樣式項目。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
ApplyStyleSheetSkin(Page) |
將頁面樣式表中所定義的樣式屬性套用至控制項。 (繼承來源 Control) |
BeginRenderTracing(TextWriter, Object) |
開始進行轉譯資料的設計階段追蹤。 (繼承來源 Control) |
BuildProfileTree(String, Boolean) |
收集伺服器控制項的相關資訊,並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。 (繼承來源 Control) |
ClearCachedClientID() |
將快取的 ClientID 值設定為 |
ClearChildControlState() |
刪除伺服器控制項之子控制項的控制項狀態資訊。 (繼承來源 Control) |
ClearChildState() |
刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。 (繼承來源 Control) |
ClearChildViewState() |
刪除所有伺服器控制項之子控制項的檢視狀態資訊。 (繼承來源 Control) |
ClearEffectiveClientIDMode() |
將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit。 (繼承來源 Control) |
CopyBaseAttributes(WebControl) |
將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
CreateChildControls() |
由 ASP.NET 網頁架構呼叫,通知使用組合實作的伺服器控制項來建立所包含的任何子控制項,以準備回傳或呈現。 (繼承來源 Control) |
CreateControlCollection() |
建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。 (繼承來源 Control) |
CreateControlStyle() |
建立樣式物件,這個物件是由 Panel 控制項在內部使用,以實作所有的樣式相關屬性。 (繼承來源 Panel) |
DataBind() |
將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。 |
DataBind(Boolean) |
使用會引發 DataBinding 事件的選項,繫結資料來源至叫用的伺服器控制項及其所有子控制項。 (繼承來源 Control) |
DataBindChildren() |
繫結資料來源至伺服器控制項的子控制項。 (繼承來源 Control) |
Dispose() |
啟用伺服器控制項,在它從記憶體釋放之前執行最後清除。 (繼承來源 Control) |
EndRenderTracing(TextWriter, Object) |
結束轉譯資料的設計階段追蹤。 (繼承來源 Control) |
EnsureChildControls() |
判斷伺服器控制項是否包含子控制項。 如果不包含,則建立子控制項。 (繼承來源 Control) |
EnsureID() |
為尚未指定識別項的控制項,建立識別項。 (繼承來源 Control) |
Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
FindControl(String) |
在目前命名容器搜尋具有指定 |
FindControl(String, Int32) |
使用指定的 |
Focus() |
設定控制項的輸入焦點。 (繼承來源 Control) |
GetDesignModeState() |
取得控制項的設計階段資料。 (繼承來源 Control) |
GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
GetRouteUrl(Object) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
GetRouteUrl(RouteValueDictionary) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
GetRouteUrl(String, Object) |
取得 URL,此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
GetRouteUrl(String, RouteValueDictionary) |
取得 URL,此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
GetUniqueIDRelativeTo(Control) |
傳回指定之控制項 UniqueID 屬性的前置部分。 (繼承來源 Control) |
HasControls() |
判斷伺服器控制項是否包含任何子控制項。 (繼承來源 Control) |
HasEvents() |
傳回值,指出控制項或任何子控制項的事件是否已註冊。 (繼承來源 Control) |
IsLiteralContent() |
判斷伺服器控制項是否只儲存常值內容。 (繼承來源 Control) |
LoadControlState(Object) |
從 SaveControlState() 方法所儲存的上一頁要求中,還原控制項狀態資訊。 (繼承來源 Control) |
LoadViewState(Object) |
從上一個使用 SaveViewState() 方法儲存的要求中,還原檢視狀態資訊。 (繼承來源 WebControl) |
MapPathSecure(String) |
擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。 (繼承來源 Control) |
MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
MergeStyle(Style) |
將指定樣式的任何非空白項目複製到 Web 控制項,但不覆寫控制項的任何現有樣式項目。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
OnBubbleEvent(Object, EventArgs) |
決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。 (繼承來源 Control) |
OnDataBinding(EventArgs) |
引發 DataBinding 事件。 (繼承來源 Control) |
OnInit(EventArgs) |
引發 Init 事件。 (繼承來源 Control) |
OnLoad(EventArgs) |
引發 Load 事件。 (繼承來源 Control) |
OnPreRender(EventArgs) |
引發 PreRender 事件。 (繼承來源 Control) |
OnUnload(EventArgs) |
引發 Unload 事件。 (繼承來源 Control) |
OpenFile(String) |
取得用來讀取檔案的 Stream。 (繼承來源 Control) |
RaiseBubbleEvent(Object, EventArgs) |
指派事件的任何來源和它的資訊至控制項的父控制項。 (繼承來源 Control) |
RemovedControl(Control) |
從 Control 物件的 Controls 集合中移除子控制項之後呼叫。 (繼承來源 Control) |
Render(HtmlTextWriter) |
將控制項呈現在指定的 HTML 寫入器中。 (繼承來源 WebControl) |
RenderBeginTag(HtmlTextWriter) |
將 Panel 控制項的 HTML 開頭標記呈現在指定的寫入器中。 (繼承來源 Panel) |
RenderChildren(HtmlTextWriter) |
將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件,再由這個物件在用戶端上寫入要轉譯的內容。 (繼承來源 Control) |
RenderContents(HtmlTextWriter) |
將控制項的內容呈現在指定的寫入器。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
RenderControl(HtmlTextWriter) |
將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件,並在啟用追蹤時儲存控制項的追蹤資訊。 (繼承來源 Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
使用提供的 HtmlTextWriter 物件,輸出伺服器控制項內容至提供的 ControlAdapter 物件。 (繼承來源 Control) |
RenderEndTag(HtmlTextWriter) |
將 Panel 控制項的 HTML 結尾標記呈現在指定的寫入器中。 (繼承來源 Panel) |
ResolveAdapter() |
取得負責呈現指定之控制項的控制項配置器。 (繼承來源 Control) |
ResolveClientUrl(String) |
取得瀏覽器可使用的 URL。 (繼承來源 Control) |
ResolveUrl(String) |
將 URL 轉換為要求用戶端可使用的 URL。 (繼承來源 Control) |
SaveControlState() |
儲存頁面回傳至伺服器以來,所發生的任何伺服器控制項狀態變更。 (繼承來源 Control) |
SaveViewState() |
儲存叫用 TrackViewState() 方法後已修改的任何狀態。 (繼承來源 WebControl) |
SetDesignModeState(IDictionary) |
設定控制項的設計階段資料。 (繼承來源 Control) |
SetRenderMethodDelegate(RenderMethod) |
指定事件處理常式委派,以呈現伺服器控制項及其內容至其父控制項。 (繼承來源 Control) |
SetTraceData(Object, Object) |
使用追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
SetTraceData(Object, Object, Object) |
使用追蹤的物體、追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
TrackViewState() |
讓控制項追蹤其檢視狀態的變更,以便將這些變更儲存在物件的 ViewState 屬性中。 (繼承來源 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) |
針對指定的資料控制項啟用動態資料行為。 |