EditorZoneBase 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
作為充當 EditorPart 控制項容器之所有區域控制項的基底類別。
public ref class EditorZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone
public abstract class EditorZoneBase : System.Web.UI.WebControls.WebParts.ToolZone
type EditorZoneBase = class
inherit ToolZone
Public MustInherit Class EditorZoneBase
Inherits ToolZone
- 繼承
- 衍生
範例
下列程式碼範例示範 類別的數個 EditorZoneBase 宣告式和程式設計用法。 因為類別是抽象的,所以程式碼範例會使用隨附于 Web 元件控制項集的衍生 EditorZone 類別,示範其繼承自 EditorZoneBase 類別的屬性和方法。
程式碼範例有四個部分:
使用者控制項,可讓您變更網頁上的顯示模式。
包含 控制項的 EditorZone 網頁。
示範某些類別成員的 EditorZoneBase 自訂 EditorZone 類別。
範例在瀏覽器中運作方式的描述。
使用者控制項的原始程式碼來自另一個主題。 若要讓此程式碼範例能夠運作,您必須從逐步解說 :變更網頁元件頁面上的顯示模式 主題中取得使用者控制項的 .ascx 檔案,並將檔案放在此程式碼範例中與 .aspx 頁面相同的資料夾中。
程式碼範例的第二個部分是網頁,其中包含控制項的 EditorZone 宣告式參考。 靠近頁面頂端是 Register
使用者控制項的指示詞。 使用者控制項標籤會在頁面中使用 <uc1:DisplayModeMenu>
元素宣告。 請注意,元素 <asp:WebPartZone>
下方是 <asp:EditorZone>
包含 EditorPart 控制項的專案,而且已設定各種標記和屬性,以判斷其外觀和行為。 頁面中大部分的程式碼都示範屬性和方法的各種程式設計用法 EditorZoneBase 。
<%@ Page Language="C#" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuCS"
src="displaymodecs.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3>
// <snippet4>
void Button1_Click(object sender, EventArgs e)
{
if (EditorZone1.ApplyVerb.Enabled)
EditorZone1.ApplyVerb.Enabled = false;
else
EditorZone1.ApplyVerb.Enabled = true;
}
// </snippet4>
// <snippet5>
void Button2_Click(object sender, EventArgs e)
{
if (EditorZone1.CancelVerb.Enabled)
EditorZone1.CancelVerb.Enabled = false;
else
EditorZone1.CancelVerb.Enabled = true;
}
// </snippet5>
// <snippet6>
void Button3_Click(object sender, EventArgs e)
{
Label1.Text = "<br />";
foreach (EditorPart part in EditorZone1.EditorParts)
{
Label1.Text += part.ID + "<br />";
}
}
// </snippet6>
// <snippet7>
void Button4_Click(object sender, EventArgs e)
{
if (EditorZone1.OKVerb.Enabled)
EditorZone1.OKVerb.Enabled = false;
else
EditorZone1.OKVerb.Enabled = true;
}
// </snippet7>
// </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>EditorZoneBase Examples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
<aspSample:MyEditorZone ID="EditorZone1" runat="server">
<ApplyVerb Text="Apply Changes" />
<CancelVerb Text="Cancel Changes" />
<OKVerb Text="Finished" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyEditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorParts Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Toggle OKVerb Enabled" OnClick="Button4_Click" />
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuVB"
src="displaymodevb.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet3>
' <snippet4>
Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
If EditorZone1.ApplyVerb.Enabled Then
EditorZone1.ApplyVerb.Enabled = False
Else
EditorZone1.ApplyVerb.Enabled = True
End If
End Sub
' </snippet4>
' <snippet5>
Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
If EditorZone1.CancelVerb.Enabled Then
EditorZone1.CancelVerb.Enabled = False
Else
EditorZone1.CancelVerb.Enabled = True
End If
End Sub
' </snippet5>
' <snippet6>
Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = "<br />"
Dim part As EditorPart
For Each part In EditorZone1.EditorParts
Label1.Text += part.ID + "<br />"
Next part
End Sub
' </snippet6>
' <snippet7>
Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
If EditorZone1.OKVerb.Enabled Then
EditorZone1.OKVerb.Enabled = False
Else
EditorZone1.OKVerb.Enabled = True
End If
End Sub
' </snippet7>
' </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>EditorZoneBase Examples</title>
</head>
<body>
<form id="form1" runat="server">
<asp:WebPartManager ID="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links" >
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Calendar ID="Calendar1" Runat="server"
Title="My Calendar" />
</ZoneTemplate>
</asp:WebPartZone>
<aspSample:MyEditorZone ID="EditorZone1" runat="server">
<ApplyVerb Text="Apply Changes" />
<CancelVerb Text="Cancel Changes" />
<OKVerb Text="Finished" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyEditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorParts Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Toggle OKVerb Enabled" OnClick="Button4_Click" />
</form>
</body>
</html>
程式碼範例的第三個部分是自訂 EditorZone 類別,示範如何使用一 EditorZoneBase 些類別成員。 自訂類別衍生自 EditorZone ,以便與網頁宣告式標記中的區域範本搭配使用。 若要執行程式碼範例,您必須編譯此原始程式碼。 您可以明確地編譯它,並將產生的元件放在網站的 Bin 資料夾或全域組件快取中。 或者,您可以將原始程式碼放在月臺的 App_Code 資料夾中,其將在執行時間動態編譯。 此程式碼範例會使用動態編譯;因此,您會發現 Register
網頁頂端附近的 指示詞不會參考元件檔案。 如需示範這兩種編譯方法的逐步解說,請參閱逐步解說 :開發和使用自訂 Web 服務器控制項。
using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
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 MyEditorZone : EditorZone
{
public MyEditorZone()
{
}
protected override void OnDisplayModeChanged(object sender,
WebPartDisplayModeEventArgs e)
{
this.BackColor = Color.LightGray;
base.OnDisplayModeChanged(sender, e);
}
protected override void OnSelectedWebPartChanged(object sender,
WebPartEventArgs e)
{
if (e.WebPart != null)
e.WebPart.Zone.SelectedPartChromeStyle.BackColor =
Color.LightGreen;
base.OnSelectedWebPartChanged(sender, e);
}
protected override void RenderBody(HtmlTextWriter writer)
{
writer.WriteLine("<hr />");
base.RenderBody(writer);
}
protected override void RenderVerbs(HtmlTextWriter writer)
{
WebPartVerb[] verbs = new WebPartVerb[] { OKVerb,
CancelVerb, ApplyVerb };
foreach (WebPartVerb verb in verbs)
{
if (verb != null)
verb.Text += " Verb";
}
base.RenderVerbs(writer);
}
}
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
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 MyEditorZone
Inherits EditorZone
Public Sub New()
End Sub
Protected Overrides Sub OnDisplayModeChanged(ByVal sender _
As Object, ByVal e As WebPartDisplayModeEventArgs)
Me.BackColor = Color.LightGray
MyBase.OnDisplayModeChanged(sender, e)
End Sub
Protected Overrides Sub OnSelectedWebPartChanged(ByVal sender _
As Object, ByVal e As WebPartEventArgs)
If Not (e.WebPart Is Nothing) Then
e.WebPart.Zone.SelectedPartChromeStyle.BackColor = _
Color.LightGreen
End If
MyBase.OnSelectedWebPartChanged(sender, e)
End Sub
Protected Overrides Sub RenderBody(ByVal writer As _
HtmlTextWriter)
writer.WriteLine("<hr />")
MyBase.RenderBody(writer)
End Sub
Protected Overrides Sub RenderVerbs(ByVal writer As _
HtmlTextWriter)
Dim verbs() As WebPartVerb = {OKVerb, CancelVerb, ApplyVerb}
Dim verb As WebPartVerb
For Each verb In verbs
If Not (verb Is Nothing) Then
verb.Text += " Verb"
End If
Next verb
MyBase.RenderVerbs(writer)
End Sub
End Class
End Namespace
當您在瀏覽器中載入頁面時,您可以從下拉式清單中選取 [ 編輯模式 ],以切換至編輯模式。 您可以按一下動詞功能表, (兩個控制項之一標題列中的向下箭號) ,然後按一下 [編輯 ] 來編輯控制項。 當編輯 UI 可見時,您可以看到類別成員的各種宣告式和程式設計用法 EditorZoneBase 的效果。
備註
類別 EditorZoneBase 是繼承自 ToolZone 類別的特殊區域類別,並為包含 EditorPart 控制項的衍生區域提供一組基底行為。 有數種 ToolZone 其他類型的類別;如需詳細資訊,請參閱 類別的概 ToolZone 觀主題。 與其他工具區域一樣, EditorZoneBase 當頁面處於一般瀏覽模式時,區域不會顯示;只有在頁面處於編輯顯示模式時,才會顯示區域。 如同其他工具區域, EditorZoneBase 區域只能包含其設計來包含 (的特殊類型控制項,在此情況下, EditorPart 控制項) 。
區域 EditorZoneBase 會為它們所包含的編輯控制項提供特殊的 UI。 這些 UI 元素有許多是 Web 元件控制項集中所有區域通用的。 如需 Web 元件區域中通用 UI 元素的詳細討論,請參閱 類別的 WebZone 類別概觀主題。
因為類別 EditorZoneBase 是抽象的,所以您無法直接在網頁上使用它。 相反地,您必須使用繼承自 類別的 EditorZoneBase 控制項,並實作其行為。 您可以使用 Web 元件控制項集、 EditorZone 控制項中提供的衍生區域,也可以衍生自己的自訂 EditorZoneBase 控制項。
類別 EditorZoneBase 提供一般使用者介面 (UI) ,以包含特殊控制項,可讓使用者編輯控制項的屬性、配置、外觀和其他屬性 WebPart 。 套用至 UI 的某些屬性是指動詞命令,例如 ApplyVerb 、 CancelVerb 和 OKVerb 屬性。 動詞是使用者在頁面上執行的常見動作,並以按鈕、連結、功能表項目或其他元素在 UI 中表示。 例如,當使用者編輯控制項上的屬性時,他們可以按一下套用動詞命令來儲存變更。
其他數個屬性會影響在編輯 UI 中各種點顯示的文字。 這些包括 EmptyZoneText 、 ErrorText 、 HeaderText 和 InstructionText 屬性。
兩個重要屬性提供相關控制項的參考。 屬性 EditorParts 是區域中所包含的控制項集合 EditorPart 。 屬性 WebPartToEdit 是 包含在 中的 WebPartZone 控制項的物件參考,可能是 WebPart 控制項或任何其他 ASP.NET 伺服器控制項、使用者控制項或自訂控制項目前正在編輯。
最後, EditorPartChrome 屬性會參考與區域相關聯的物件實例 EditorPartChrome ,並且包含周邊 UI 元素的樣式特性, (稱為 chrome) ,例如區域中控制項的標題和框線樣式 EditorPart 。
類別的 EditorZoneBase 一些方法特別用來處理其他控制項的編輯。 方法 Close 會將頁面從編輯顯示模式變更回一般流覽檢視。 方法是 CreateEditorPartChrome 建立 chrome (周邊 UI 元素,例如框線、動詞、圖示,以及圍繞區域中每個 EditorPart 控制項的標題) 。 方法是 CreateEditorParts 抽象方法;衍生類別會覆寫它,以建立區域中包含之所有 EditorPart 控制項的實例。 InvalidateEditorParts如果區域中的控制項集合 EditorPart 因某些程式設計原因而變更,則衍生類別可以呼叫 方法,這會標示要重新建立及更新控制項集合的 EditorPart Web 元件控制項。 當顯示模式從編輯模式變更回瀏覽模式時,會 OnDisplayModeChanged 使用 方法將控制項 null
集合 EditorPart 設定為 。 最後,當控制項進入或離開編輯模式時 WebPart , OnSelectedWebPartChanged 會使用 方法來處理事件。 例如,這個方法是一個方便的地方,可將控制項的 WebPart 屬性值與相關聯 EditorPart 控制項中的可編輯值進行同步處理。
給實施者的注意事項
如果您想要開發用於裝載 EditorPart 控制項的自訂區域,您必須判斷是否要提供區域範本支援。 區域範本是由實 ITemplate 作 介面的類型所建立,而且如果您想要使用自訂區域啟用頁面開發人員,以在網頁的宣告式標記中參考 EditorPart 您區域內的控制項,則為必要專案。 如果您需要區域範本支援,您應該繼承自 EditorZone 類別。
相反地,如果您的自訂區域及其 EditorPart 控制項會獨立建立,而且會以程式設計方式建立它們,而不會讓頁面開發人員在區域範本中以宣告方式指定控制項,則您可以直接從 EditorZoneBase 類別繼承。 如果您這樣做,請務必實 CreateEditorParts() 作 方法,讓您的自訂區域能夠運作。
建構函式
EditorZoneBase() |
初始化這個類別,以供繼承的類別執行個體使用。 這個建構函式只能由繼承的類別呼叫。 |
屬性
AccessKey |
取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
ApplyVerb |
取得 WebPartVerb 物件參考,其可讓使用者可將編輯變更套用至處於編輯模式的控制項。 |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
AssociatedDisplayModes |
取得與特定 WebPartDisplayMode 區域相關聯的 ToolZone 物件集合。 (繼承來源 ToolZone) |
Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
BackImageUrl |
取得或設定區域背景影像的 URL。 (繼承來源 WebZone) |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
CancelVerb |
取得 WebPartVerb 物件參考,其可讓使用者取消對處於編輯模式之控制項的編輯變更。 |
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) |
Display |
取得值,其中該值指出目前是否顯示 ToolZone 控制項。 |
EditorPartChrome |
取得與 EditorPartChrome 區域相關聯之 EditorZoneBase 類別執行個體的參考。 |
EditorParts |
取得 EditorPart 區域中包含之所有 EditorZoneBase 控制項的集合。 |
EditUIStyle |
取得 ToolZone 控制項包含之控制項的樣式屬性。 (繼承來源 ToolZone) |
EmptyZoneText |
取得或設定區域不包含控制項時出現的訊息。 |
EmptyZoneTextStyle |
取得空區域中替代符號文字的樣式屬性。 (繼承來源 WebZone) |
Enabled |
取得或設定值,指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
ErrorStyle |
取得呈現錯誤訊息的樣式屬性,無法載入或建立 WebPart 控制項時會顯示該錯誤訊息。 (繼承來源 WebZone) |
ErrorText |
取得或設定在編輯使用者介面 (UI) 頂端顯示的區域層級錯誤訊息文字。 |
Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
Font |
取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 WebControl) |
FooterStyle |
取得區域頁尾區內容的樣式屬性。 (繼承來源 WebZone) |
ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
HasAttributes |
取得值,指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
HasChildViewState |
取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
HasFooter |
取得值,表示區域是否具有頁尾區。 (繼承來源 WebZone) |
HasHeader |
取得值,表示區域是否具有頁首區。 (繼承來源 WebZone) |
HeaderCloseVerb |
取得 WebPartVerb 控制項頁首中 ToolZone 物件的參考,該物件用於關閉控制項。 (繼承來源 ToolZone) |
HeaderStyle |
取得區域頁首區內容的樣式屬性。 (繼承來源 WebZone) |
HeaderText |
取得或設定區域的頁首區域文字。 |
HeaderVerbStyle |
取得顯示於 ToolZone 控制項中所有頁首動詞命令的樣式屬性。 (繼承來源 ToolZone) |
Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
InstructionText |
取得或設定 ToolZone 控制項中的文字,可提供使用者指示。 |
InstructionTextStyle |
取得顯示在 ToolZone 控制項頂端之指示文字的樣式屬性。 (繼承來源 ToolZone) |
IsChildControlStateCleared |
取得值,指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
IsEnabled |
取得值,指出是否啟用控制項。 (繼承來源 WebControl) |
IsTrackingViewState |
取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
IsViewStateEnabled |
取得值,指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
LabelStyle |
取得標籤內容的樣式屬性,該標籤顯示在 ToolZone 控制項中的編輯控制項旁。 衍生的 ToolZone 控制項 (例如 CatalogZone 和 EditorZone) 會將樣式套用至標籤。 (繼承來源 ToolZone) |
LoadViewStateByID |
取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
NamingContainer |
取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
OKVerb |
取得 WebPartVerb 物件參考,該物件將編輯變更套用至處於編輯模式的控制項,並隱藏編輯使用者介面 (UI)。 |
Padding |
取得或設定表格的儲存格填補屬性,該表格包含區域的 WebPart 控制項。 (繼承來源 WebZone) |
Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
PartChromePadding |
取得或設定 WebPart 控制項的內容與此控制項的框線之間的距離。 (繼承來源 WebZone) |
PartChromeStyle |
取得樣式特性,該樣式特性套用至區域中 Web 組件控制項的框線。 (繼承來源 WebZone) |
PartChromeType |
取得或設定區域中架構 Web 組件控制項的框線類型。 (繼承來源 WebZone) |
PartStyle |
取得樣式特性,該樣式特性套用至區域中每個 Web 組件控制項的框線和內容。 (繼承來源 WebZone) |
PartTitleStyle |
取得區域中每個 Web 組件控制項標題列內容的樣式屬性。 (繼承來源 WebZone) |
RenderClientScript |
取得值,指出是否在 Web 組件頁面上呈現用戶端指令碼。 (繼承來源 WebZone) |
RenderingCompatibility |
取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
Site |
當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
Style |
取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
SupportsDisabledAttribute |
取得值,這個值表示當控制項的 |
TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebZone) |
TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
ValidateRequestMode |
取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
VerbButtonType |
取得或設定用於表示區域動詞命令的按鈕類型。 (繼承來源 WebZone) |
VerbStyle |
取得使用者介面 (UI) 動詞命令的樣式屬性,該動詞命令與區域中的 Web 組件控制項相關聯。 (繼承來源 WebZone) |
ViewState |
取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
ViewStateIgnoresCase |
取得值,指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
Visible |
取得或設定值,指出伺服器控制項是否要呈現為網頁上的使用者介面 (UI) 項目。 (繼承來源 ToolZone) |
WebPartManager |
取得 WebPartManager 控制項的參考,該控制項與 Web 組件頁面上的 WebZone 控制項執行個體相關聯。 (繼承來源 WebZone) |
WebPartToEdit |
取得對目前正在編輯之 WebPart 控制項的參考。 |
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 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應