DataListDesigner 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
擴充 DataList Web 伺服器控制項的設計階段行為。
public ref class DataListDesigner : System::Web::UI::Design::WebControls::BaseDataListDesignerpublic class DataListDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataListDesigner : System.Web.UI.Design.WebControls.BaseDataListDesignertype DataListDesigner = class
inherit BaseDataListDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataListDesigner = class
inherit BaseDataListDesignerPublic Class DataListDesigner
Inherits BaseDataListDesigner- 繼承
- 屬性
範例
下列程式代碼範例示範如何擴充 DataListDesigner 類別。 程序代碼會覆寫 方法， GetDesignTimeHtml 以在啟用控件時 DataList 顯示紫色的五點框線。
using System;
using System.Drawing;
using System.Security.Permissions;
using System.ComponentModel;
using System.Web.UI.WebControls;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
namespace ASPNET.Examples.CS
{
[SecurityPermission(
SecurityAction.Demand,
Flags = SecurityPermissionFlag.UnmanagedCode)]
public class SimpleGridViewDesigner : GridViewDesigner
{
private SimpleGridView simpleGView;
public override string GetDesignTimeHtml()
{
string designTimeHtml = String.Empty;
simpleGView = (SimpleGridView)Component;
// Check the control's BorderStyle property to
// conditionally render design-time HTML.
if (simpleGView.BorderStyle == BorderStyle.NotSet)
{
// Save the current property settings in variables.
int oldCellPadding = simpleGView.CellPadding;
Unit oldBorderWidth = simpleGView.BorderWidth;
Color oldBorderColor = simpleGView.BorderColor;
// Set properties and generate the design-time HTML.
try
{
simpleGView.Caption = "SimpleGridView";
simpleGView.CellPadding = 1;
simpleGView.BorderWidth = Unit.Pixel(3);
simpleGView.BorderColor = Color.Red;
designTimeHtml = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
// Get HTML from the GetErrorDesignTimeHtml
// method if an exception occurs.
designTimeHtml = GetErrorDesignTimeHtml(ex);
// Return the properties to their original values.
}
finally
{
simpleGView.CellPadding = oldCellPadding;
simpleGView.BorderWidth = oldBorderWidth;
simpleGView.BorderColor = oldBorderColor;
}
}
else
{
designTimeHtml = base.GetDesignTimeHtml();
}
return designTimeHtml;
}
protected override string
GetErrorDesignTimeHtml(System.Exception exc)
{
return CreatePlaceHolderDesignTimeHtml(
"ASPNET.Examples: An error occurred while rendering the GridView.");
}
public override void Initialize(IComponent component)
{
simpleGView = (SimpleGridView)component;
base.Initialize(component);
}
}
}
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Security
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Namespace ASPNET.Examples
< _
Designer("ASPNET.Examples.Design.SimpleGridViewDesigner", _
"System.Web.UI.Design.GridViewDesigner") _
> _
Public Class SimpleGridView
Inherits GridView
' Code to customize your GridView goes here
End Class
End Namespace
Namespace ASPNET.Examples.Design
<Permissions.SecurityPermission( _
Permissions.SecurityAction.Demand, _
Flags:=Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SimpleGridViewDesigner
Inherits GridViewDesigner
Private simpleGView As SimpleGridView
Public Overrides Function GetDesignTimeHtml() As String
Dim designTimeHtml As String = String.Empty
simpleGView = CType(Component, SimpleGridView)
' Check the control's BorderStyle property to
' conditionally render design-time HTML.
If (simpleGView.BorderStyle = BorderStyle.NotSet) Then
' Save the current property settings in variables.
Dim oldCellPadding As Integer = simpleGView.CellPadding
Dim oldBorderWidth As Unit = simpleGView.BorderWidth
Dim oldBorderColor As Color = simpleGView.BorderColor
' Set properties and generate the design-time HTML.
Try
simpleGView.Caption = "SimpleGridView"
simpleGView.CellPadding = 1
simpleGView.BorderWidth = Unit.Pixel(3)
simpleGView.BorderColor = Color.Red
designTimeHtml = MyBase.GetDesignTimeHtml()
Catch ex As Exception
' Get HTML from the GetErrorDesignTimeHtml
' method if an exception occurs.
designTimeHtml = GetErrorDesignTimeHtml(ex)
' Return the properties to their original values.
Finally
simpleGView.CellPadding = oldCellPadding
simpleGView.BorderWidth = oldBorderWidth
simpleGView.BorderColor = oldBorderColor
End Try
Else
designTimeHtml = MyBase.GetDesignTimeHtml()
End If
Return designTimeHtml
End Function
Protected Overrides Function _
GetErrorDesignTimeHtml(ByVal exc As Exception) As String
Return CreatePlaceHolderDesignTimeHtml( _
"ASPNET.Examples: An error occurred while rendering the GridView.")
End Function
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleGView = CType(component, SimpleGridView)
MyBase.Initialize(component)
End Sub
End Class
End Namespace
下列程式代碼範例示範如何使用 DesignerAttribute 將設計工具與 DataList 控件產生關聯。
[ Designer("ASPNET.Examples.Design.SimpleGridViewDesigner",
"System.Web.UI.Design.GridViewDesigner")]
public class SimpleGridView : GridView
{
// Code to customize your GridView goes here
}
< _
Designer("ASPNET.Examples.Design.SimpleGridViewDesigner", _
"System.Web.UI.Design.GridViewDesigner") _
> _
Public Class SimpleGridView
Inherits GridView
' Code to customize your GridView goes here
End Class
建構函式
| DataListDesigner() |
初始化 DataListDesigner 類別的新執行個體。 |
屬性
| ActionLists |
取得此設計工具的行動清單集合。 (繼承來源 BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
已淘汰.
取得作用中的樣板編輯框架 (Frame)。 (繼承來源 TemplatedControlDesigner) |
| AllowResize |
取得值，指出是否可以調整 DataList 控制項的大小。 |
| AssociatedComponents |
取得元件集合，該集合與設計工具管理的元件相關聯。 (繼承來源 ComponentDesigner) |
| AutoFormats |
取得與這個設計工具關聯的 DesignerAutoFormatCollection 物件。 |
| AutoFormats |
針對設計階段的相關聯控制項，取得要在 [自動格式化] 對話方塊中顯示之預先定義的自動格式化配置集合。 (繼承來源 ControlDesigner) |
| Behavior |
已淘汰.
取得或設定與設計工具相關聯的 DHTML 行為。 (繼承來源 HtmlControlDesigner) |
| CanEnterTemplateMode |
取得值，指出這個設計工具是否允許檢視或編輯樣板。 (繼承來源 TemplatedControlDesigner) |
| Component |
取得這個設計工具正在設計的元件。 (繼承來源 ComponentDesigner) |
| DataBindings |
取得目前控制項的資料繫結 (Data Binding) 集合。 (繼承來源 HtmlControlDesigner) |
| DataBindingsEnabled |
取得值，指出設計工具是否允許資料繫結。 (繼承來源 TemplatedControlDesigner) |
| DataKeyField |
取得或設定關聯控制項的資料索引鍵欄位值。 (繼承來源 BaseDataListDesigner) |
| DataMember |
取得或設定關聯控制項的資料成員欄位值。 (繼承來源 BaseDataListDesigner) |
| DataSource |
取得或設定關聯控制項的資料來源屬性值。 (繼承來源 BaseDataListDesigner) |
| DataSourceDesigner |
在選取資料來源進行資料繫結時，取得資料來源的設計工具。 (繼承來源 BaseDataListDesigner) |
| DataSourceID |
取得或設定設計工具版資料來源 ID 屬性，並用來遮蔽關聯控制項的對應屬性。 (繼承來源 BaseDataListDesigner) |
| DesignerState |
取得物件，用於在設計階段保存關聯控制項的資料。 (繼承來源 ControlDesigner) |
| DesignerView |
取得繫結至關聯控制項的資料來源之預設檢視。 (繼承來源 BaseDataListDesigner) |
| DesignTimeElement |
已淘汰.
取得設計階段物件，表示與設計介面上 HtmlControlDesigner 物件相關聯的控制項。 (繼承來源 HtmlControlDesigner) |
| DesignTimeElementView |
已淘汰.
取得控制項設計工具的檢視控制項物件。 (繼承來源 ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
取得值，指出是否必須完成載入才會顯示設計階段標記。 (繼承來源 BaseDataListDesigner) |
| Expressions |
在設計階段取得目前控制項的運算式繫結。 (繼承來源 HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
取得值，指出當控制項置於樣板編輯模式時是否會隱藏控制項的屬性。 (繼承來源 TemplatedControlDesigner) |
| ID |
取得或設定控制項的 ID 字串。 (繼承來源 ControlDesigner) |
| InheritanceAttribute |
取得屬性 (Attribute)，表示相關元件的繼承 (Inheritance) 型別。 (繼承來源 ComponentDesigner) |
| Inherited |
取得值，表示是否要繼承這個元件。 (繼承來源 ComponentDesigner) |
| InTemplateMode |
已淘汰.
取得值，指出設計工具文件是否處於樣板模式。 (繼承來源 TemplatedControlDesigner) |
| IsDirty |
已淘汰.
取得或設定值，指出 Web 伺服器控制項是否已標記為變更。 (繼承來源 ControlDesigner) |
| ParentComponent |
取得這個設計工具的父元件。 (繼承來源 ComponentDesigner) |
| ReadOnly |
已淘汰.
取得或設定值，指出控制項屬性於設計階段是否為唯讀。 (繼承來源 ControlDesigner) |
| RootDesigner |
為包含關聯控制項的 Web Form 網頁，取得控制項設計工具。 (繼承來源 ControlDesigner) |
| SetTextualDefaultProperty |
擴充 DataList Web 伺服器控制項的設計階段行為。 (繼承來源 ComponentDesigner) |
| ShadowProperties |
取得覆寫使用者設定的屬性值集合。 (繼承來源 ComponentDesigner) |
| ShouldCodeSerialize |
已淘汰.
取得或設定值，指出是否應該於序列化 (Serialization) 期間，在程式碼後置 (Code-Behind) 檔案中為目前設計文件建立控制項的欄位宣告。 (繼承來源 HtmlControlDesigner) |
| Tag |
取得物件，表示關聯控制項的 HTML 標記項目。 (繼承來源 ControlDesigner) |
| TemplateGroups |
取得樣板群組的集合，每一個樣板群組都包含一個樣板定義。 (繼承來源 TemplatedControlDesigner) |
| TemplatesExist |
取得值，指出是否為關聯控制項定義了樣板。 |
| UsePreviewControl |
取得值，其中該值會表示控制項設計工具是否使用暫時預覽控制項以產生設計階段 HTML 標記。 (繼承來源 ControlDesigner) |
| Verbs |
取得此設計工具可用的動詞命令集合。 (繼承來源 BaseDataListDesigner) |
| ViewControl |
取得或設定 Web 伺服器控制項，可用於預覽設計階段的 HTML 標記。 (繼承來源 ControlDesigner) |
| ViewControlCreated |
取得或設定值，指出是否已建立 |
| Visible |
取得值，這個值表示控制項在設計階段是否為可見的。 (繼承來源 ControlDesigner) |
