EditorZone 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
作為在網頁上裝載 EditorPart 控制項之網頁組件控制項集合中的主要控制項。
public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBase
public class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBase
type EditorZone = class
inherit EditorZoneBase
Public Class EditorZone
Inherits EditorZoneBase
- 繼承
範例
下列程式碼範例示範類別的 EditorZone 數個宣告式和程式設計用法。 此範例會建立繼承自 類別的 EditorZone 自訂編輯器區域,並在網頁元件頁面中使用它。
程式碼範例有三個部分:
使用者控制項,可讓您變更網頁上的顯示模式。
參考自訂 EditorZone 控制項的網頁。
範例運作方式的說明。
此程式碼範例的第一個部分是使用者控制項,可讓使用者變更網頁上的顯示模式。 如需此控制項中顯示模式和原始程式碼描述的詳細資訊,請參閱逐步解說 :變更網頁元件頁面上的顯示模式。
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName + " Mode", modeName);
DisplayModeDropdown.Items.Add(item);
}
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender,
EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
void Page_PreRender(object sender, EventArgs e)
{
DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
}
</script>
<div>
<asp:DropDownList ID="DisplayModeDropdown"
runat="server"
AutoPostBack="true"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName + " Mode", modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name
End Sub
</script>
<div>
<asp:DropDownList ID="DisplayModeDropdown"
runat="server"
AutoPostBack="true"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
程式碼範例的第二個部分是網頁。 靠近頁面頂端的 指示詞是 Register
使用者控制項的指示詞。 使用者控制項標籤會在頁面中宣告,且具有 uc1:
元素前置詞。 請注意,元素 <asp:WebPartZone>
下方是包含數 EditorPart 個 <asp:EditorZone>
控制項的專案,其中已設定一些標記和屬性來判斷其外觀和行為。 還有一些方法可以程式設計方式存取控制項的各種 EditorZone 成員。
<%@ Page Language="C#" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuCS"
src="displaymodecs.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3>
void Button1_Click(object sender, EventArgs e)
{
if (EditorZone1.ApplyVerb.Enabled == true)
EditorZone1.ApplyVerb.Enabled = false;
else
EditorZone1.ApplyVerb.Enabled = true;
}
void Button2_Click(object sender, EventArgs e)
{
EditorZone1.BorderWidth = 2;
EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
}
void Button3_Click(object sender, EventArgs e)
{
Label1.Text = "<br />";
foreach (EditorPart part in EditorZone1.EditorParts)
{
Label1.Text += part.ID + "<br />";
}
}
void Button4_Click(object sender, EventArgs e)
{
EditorZone1.InstructionText = "My custom instruction text.";
}
// </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="mgr" 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>
<asp:EditorZone ID="EditorZone1" runat="server" >
<VerbStyle Font-Italic="true" />
<EditUIStyle BackColor="lightgray" />
<PartChromeStyle BorderWidth="1" />
<LabelStyle Font-Bold="true" />
<CancelVerb Text="Cancel Changes" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Enable or Disable Apply" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Set Zone BorderColor" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorPart Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Set Instruction Text" OnClick="Button4_Click" />
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1"
tagname="DisplayModeMenuVB"
src="displaymodevb.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet3>
Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
If EditorZone1.ApplyVerb.Enabled = True Then
EditorZone1.ApplyVerb.Enabled = False
Else
EditorZone1.ApplyVerb.Enabled = True
End If
End Sub
Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
EditorZone1.BorderWidth = 2
EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
End Sub
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
Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
EditorZone1.InstructionText = "My custom instruction text."
End Sub
' </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="mgr" 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>
<asp:EditorZone ID="EditorZone1" runat="server" >
<VerbStyle Font-Italic="true" />
<EditUIStyle BackColor="lightgray" />
<PartChromeStyle BorderWidth="1" />
<LabelStyle Font-Bold="true" />
<CancelVerb Text="Cancel Changes" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button ID="Button1" runat="server" Width="200"
Text="Enable or Disable Apply" OnClick="Button1_Click" />
<br />
<asp:Button ID="Button2" runat="server" Width="200"
Text="Set Zone BorderColor" OnClick="Button2_Click" />
<br />
<asp:Button ID="Button3" runat="server" Width="200"
Text="Display EditorPart Collection" OnClick="Button3_Click" />
<asp:Label ID="Label1" runat="server" />
<br />
<asp:Button ID="Button4" runat="server" Width="200"
Text="Set Instruction Text" OnClick="Button4_Click" />
</form>
</body>
</html>
當您在瀏覽器中載入頁面時,您可以在下拉式清單中選取 [ 編輯模式 ],以切換至編輯模式。 若要顯示編輯 UI,您可以按一下動詞功能表 (兩個控制項標題列中的向下箭號) ,然後按一下 [ 編輯 ] 以編輯控制項。 透過顯示編輯 UI,您可以看到宣告式和程式設計使用 EditorZone 類別成員的效果。
備註
在 Web 元件控制項集內,區域是複合控制項,涵蓋網頁上定義的區域,並包含伺服器控制項。 區域的主要功能是配置它所包含的控制項,並提供這些控制項的通用使用者介面 (UI) 。 如需區域及其在 Web 元件應用程式中使用方式的一般資訊,請參閱基 WebZone 類的參考檔,以及 Web 元件控制項集概觀。
控制項 EditorZone 是網頁元件控制項集中的基本控制項之一。 網頁元件的主要功能是使用者可以根據喜好設定修改 (或個人化) 網頁,並儲存其個人化設定以供未來的瀏覽器會話使用。 修改網頁元件頁面的一個層麵包括編輯;使用者可以編輯可見 WebPart 控制項的外觀、版面配置、行為和其他屬性。 網頁元件控制項集中的數個控制項提供編輯功能,包括 EditorZone 控制項。
EditorZone當網頁元件頁面進入編輯模式時,控制項就會變成可見的,而且它可讓您使用各種 EditorPart 控制項來個人化 WebPart 控制項。 控制項 EditorZone 與其父 EditorZoneBase 系非常類似,其類別有一個主要差異: EditorZone 控制項會提供在其 ZoneTemplate 屬性中參考的區域範本。 區域範本會新增以頁面持續性格式宣告內容的能力。 頁面開發人員可以將控制項放在 EditorZone 網頁的宣告式標記中、新增子 <zonetemplate>
元素,以及在 元素中 <zonetemplate>
加入宣告式參考至 EditorPart 控制項。
控制項 EditorZone 也有 方法, CreateEditorParts 它會覆寫 類別中的 EditorZoneBase 基底方法。 這個方法是必要的, EditorZone 讓控制項可以建立區域範本,以包含以宣告方式新增至區域的任何 EditorPart 控制項。
注意
UI 中的 EditorZone 按鈕需要用戶端腳本才能正常運作。 如果在瀏覽器中停用腳本,使用者將無法透過 EditorZone UI 執行動作。
Accessibility
根據預設,此控制項轉譯的標記可能不符合協助工具標準,例如 Web 內容協助工具指導方針 1.0 (WCAG) 優先順序 1 指導方針。 如需此控制項協助工具支援的詳細資訊,請參閱 ASP.NET 控制項和協助工具。
給繼承者的注意事項
如果您想要建立自訂 EditorZone 區域,以更充分掌控編輯 UI 的轉譯,只要您不需要為頁面開發人員提供區域範本支援, EditorPart 即可以宣告方式繼承至 EditorZoneBase 類別。 在這種情況下,您會以程式設計方式將所有 EditorPart 控制項新增至區域。 如果您想要提供區域範本支援,您應該繼承自 EditorZone 類別。
建構函式
EditorZone() |
初始化 EditorZone 類別的新執行個體。 |
屬性
AccessKey |
取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
ApplyVerb |
取得 WebPartVerb 物件參考,其可讓使用者可將編輯變更套用至處於編輯模式的控制項。 (繼承來源 EditorZoneBase) |
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 物件參考,其可讓使用者取消對處於編輯模式之控制項的編輯變更。 (繼承來源 EditorZoneBase) |
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 控制項。 (繼承來源 EditorZoneBase) |
EditorPartChrome |
取得與 EditorPartChrome 區域相關聯之 EditorZoneBase 類別執行個體的參考。 (繼承來源 EditorZoneBase) |
EditorParts |
取得 EditorPart 區域中包含之所有 EditorZoneBase 控制項的集合。 (繼承來源 EditorZoneBase) |
EditUIStyle |
取得 ToolZone 控制項包含之控制項的樣式屬性。 (繼承來源 ToolZone) |
EmptyZoneText |
取得或設定區域不包含控制項時出現的訊息。 (繼承來源 EditorZoneBase) |
EmptyZoneTextStyle |
取得空區域中替代符號文字的樣式屬性。 (繼承來源 WebZone) |
Enabled |
取得或設定值,指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
ErrorStyle |
取得呈現錯誤訊息的樣式屬性,無法載入或建立 WebPart 控制項時會顯示該錯誤訊息。 (繼承來源 WebZone) |
ErrorText |
取得或設定在編輯使用者介面 (UI) 頂端顯示的區域層級錯誤訊息文字。 (繼承來源 EditorZoneBase) |
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 |
取得或設定區域的頁首區域文字。 (繼承來源 EditorZoneBase) |
HeaderVerbStyle |
取得顯示於 ToolZone 控制項中所有頁首動詞命令的樣式屬性。 (繼承來源 ToolZone) |
Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
InstructionText |
取得或設定 ToolZone 控制項中的文字,可提供使用者指示。 (繼承來源 EditorZoneBase) |
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)。 (繼承來源 EditorZoneBase) |
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 控制項的參考。 (繼承來源 EditorZoneBase) |
Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
ZoneTemplate |
提供樣板,以頁面保存格式將子控制項包含在 EditorZone 控制項之中。 |
方法
事件
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 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應