共用方式為


DataGridDesigner 類別

定義

擴充 DataGrid Web 伺服器控制項的設計階段行為。

public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesigner
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner
type DataGridDesigner = class
    inherit BaseDataListDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
    inherit BaseDataListDesigner
Public Class DataGridDesigner
Inherits BaseDataListDesigner
繼承
屬性

範例

下列程式代碼範例示範如何擴充 DataGridDesigner 類別。 程式代碼會GetDesignTimeHtml覆寫 方法,CellPadding以在設計介面上呈現控件時DataGrid自定義、 BorderWidthBorderColor 屬性。

Imports System.Diagnostics
Imports System.ComponentModel
Imports System.Drawing
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls

Namespace Examples.AspNet

    ' Create a designer class for the SimpleDataList class.
    <System.Security.Permissions.SecurityPermission( _
    System.Security.Permissions.SecurityAction.Demand, _
    Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
    Public Class SimpleDataListDesigner
        Inherits DataListDesigner

        Private simpleList As SimpleDataList


        ' Override the GetDesignTimeHtml method to add style to the control
        ' on the design surface.
        Public Overrides Function GetDesignTimeHtml() As String
            ' Cast the control to the Component property of the designer.
            simpleList = CType(Component, SimpleDataList)

            Dim designTimeHtml As String = Nothing

            ' Create variables to hold current property values.
            Dim oldBorderWidth As Unit = simpleList.BorderWidth
            Dim oldBorderColor As Color = simpleList.BorderColor

            ' Set the properties and generate the design-time HTML.
            If (simpleList.Enabled) Then
                Try
                    simpleList.BorderWidth = Unit.Point(5)
                    simpleList.BorderColor = Color.Purple
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' Call the GetErrorDesignTimeHtml method if an
                    ' exception occurs.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Return the properties to their original settings.
                Finally
                    simpleList.BorderWidth = oldBorderWidth
                    simpleList.BorderColor = oldBorderColor
                End Try
                ' If the list is not enabled, call the GetEmptyDesignTimeHtml
                ' method.
            Else
                designTimeHtml = GetEmptyDesignTimeHtml()
            End If

            Return designTimeHtml

        End Function

        Protected Overrides Function GetEmptyDesignTimeHtml() As String
            Dim emptyText As String

            ' Check the CanEnterTemplateMode property to
            ' specify which text to display if ItemTemplate 
            ' does not contain a value.
            If CanEnterTemplateMode Then
                emptyText = _
                    "<b>Either the Enabled property value is false " + _
                    "or you need to set the ItemTemplate for this " + _
                    "control.<br>Right-click to edit templates.</b>"
            Else
                emptyText = _
                    "<b>You cannot edit templates in this view.<br>" + _
                    "Switch to HTML view to define the ItemTemplate.</b>"
            End If

            Return CreatePlaceHolderDesignTimeHtml(emptyText)
        End Function

        ' Generate HTML to indicate that an error has occurred.
        Protected Overrides Function GetErrorDesignTimeHtml(ByVal exc As _
            Exception) As String

            Return CreatePlaceHolderDesignTimeHtml( _
                "<b>An error occurred</b>.<br>Check to ensure that all " + _
                "properties are valid.")
        End Function


        ' Override the Initialize method to ensure that
        ' only an instance of the SimpleDataList class is
        ' used by this designer class.
        Public Overrides Sub Initialize(ByVal component As IComponent)
            simpleList = CType(component, SimpleDataList)

            If IsNothing(simpleList) Then
                Throw New ArgumentException("Must be a SimpleDataList.", "component")
            End If

            MyBase.Initialize(component)
        End Sub
    End Class
End Namespace

下列範例示範如何使用 DesignerAttribute 屬性將設計工具與 DataGrid 控件產生關聯。

' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
    simpleList = CType(component, SimpleDataList)

    If IsNothing(simpleList) Then
        Throw New ArgumentException("Must be a SimpleDataList.", "component")
    End If

    MyBase.Initialize(component)
End Sub

建構函式

DataGridDesigner()

初始化 DataGridDesigner 類別的新執行個體。

屬性

ActionLists

取得此設計工具的行動清單集合。

(繼承來源 BaseDataListDesigner)
ActiveTemplateEditingFrame
已淘汰.

取得作用中的樣板編輯框架 (Frame)。

(繼承來源 TemplatedControlDesigner)
AllowResize

取得值,指出是否可在設計階段環境中調整控制項的大小。

(繼承來源 ControlDesigner)
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

擴充 DataGrid Web 伺服器控制項的設計階段行為。

(繼承來源 ComponentDesigner)
ShadowProperties

取得覆寫使用者設定的屬性值集合。

(繼承來源 ComponentDesigner)
ShouldCodeSerialize
已淘汰.

取得或設定值,指出是否應該於序列化 (Serialization) 期間,在程式碼後置 (Code-Behind) 檔案中為目前設計文件建立控制項的欄位宣告。

(繼承來源 HtmlControlDesigner)
Tag

取得物件,表示關聯控制項的 HTML 標記項目。

(繼承來源 ControlDesigner)
TemplateGroups

取得樣板群組的集合,每一個樣板群組都包含一個樣板定義。

(繼承來源 TemplatedControlDesigner)
UsePreviewControl

取得值,其中該值會表示控制項設計工具是否使用暫時預覽控制項以產生設計階段 HTML 標記。

(繼承來源 ControlDesigner)
Verbs

取得此設計工具可用的動詞命令集合。

(繼承來源 BaseDataListDesigner)
ViewControl

取得或設定 Web 伺服器控制項,可用於預覽設計階段的 HTML 標記。

(繼承來源 ControlDesigner)
ViewControlCreated

取得或設定值,指出是否已建立 View 控制項以在設計介面上顯示。

(繼承來源 ControlDesigner)
Visible

取得值,這個值表示控制項在設計階段是否為可見的。

(繼承來源 ControlDesigner)

方法

CreateErrorDesignTimeHtml(String)

建立 HTML 標記,以在設計階段顯示指定的錯誤訊息。

(繼承來源 ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)

建立 HTML 標記,以在設計階段顯示指定的例外狀況錯誤訊息。

(繼承來源 ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

提供簡單矩形預留位置表示,顯示控制項的型別和 ID。

(繼承來源 ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

提供簡單矩形預留位置表示,顯示控制項的型別和 ID,以及其他指定的指示或資訊。

(繼承來源 ControlDesigner)
CreateTemplateEditingFrame(TemplateEditingVerb)
已淘汰.

使用指定的動作 (Verb) 以建立樣板編輯框架。

CreateViewControl()

傳回關聯控制項的複本,以便在設計介面上檢視或呈現。

(繼承來源 ControlDesigner)
Dispose()

釋放 ComponentDesigner 所使用的所有資源。

(繼承來源 ComponentDesigner)
Dispose(Boolean)

釋放 DataGridDesigner 物件所使用的 Unmanaged 資源,並選擇性釋放 Managed 資源。

DoDefaultAction()

在元件上預設事件的原始程式碼檔案中建立方法簽章,並將使用者的游標巡覽至該位置。

(繼承來源 ComponentDesigner)
EnterTemplateMode(ITemplateEditingFrame)
已淘汰.

開啟要在設計工具中編輯的特定的樣板編輯物件。

(繼承來源 TemplatedControlDesigner)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
ExitTemplateMode(Boolean, Boolean, Boolean)
已淘汰.

在儲存任何相關的變更之後關閉目前作用中的樣板編輯框架。

(繼承來源 TemplatedControlDesigner)
GetBounds()

擷取矩形的座標,表示設計介面上所顯示控制項的界限。

(繼承來源 ControlDesigner)
GetCachedTemplateEditingVerbs()
已淘汰.

取得設計工具可以使用的已快取處理的樣板編輯動作。

GetDesignTimeDataSource(IEnumerable, Int32, Boolean)

產生物件,可在設計階段用來做為資料來源。

(繼承來源 BaseDataListDesigner)
GetDesignTimeDataSource(Int32, Boolean)

產生物件,可在設計階段用來做為資料來源。

(繼承來源 BaseDataListDesigner)
GetDesignTimeHtml()

取得用來在設計階段表示 DataGrid 控制項的 HTML 標記。

GetDesignTimeHtml(DesignerRegionCollection)

擷取要顯示控制項的 HTML 標記,並將目前控制項設計工具區域填入集合中。

(繼承來源 ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

針對關聯控制項設計階段檢視的可編輯區域,傳回內容。

(繼承來源 ControlDesigner)
GetEmptyDesignTimeHtml()

取得在設計階段用來表示空樣板架構控制項的 HTML 標記。

GetErrorDesignTimeHtml(Exception)

取得當呈現控制項發生錯誤時,指定的例外狀況在設計階段所顯示的 HTML 標記。

GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetPersistenceContent()

在設計階段擷取控制項的永久性內部 HTML 標記。

(繼承來源 ControlDesigner)
GetPersistInnerHtml()

取得為相關聯之伺服器控制項執行階段中的內容所保存的標記。

(繼承來源 TemplatedControlDesigner)
GetResolvedSelectedDataSource()

從關聯的控制項容器取得資料來源元件,解析成特定資料成員。

(繼承來源 BaseDataListDesigner)
GetSelectedDataSource()

從關聯的控制項容器取得資料來源元件。

(繼承來源 BaseDataListDesigner)
GetService(Type)

嘗試從設計工具元件的設計模式站台擷取指定的服務類型。

(繼承來源 ComponentDesigner)
GetTemplateContainerDataItemProperty(String)
已淘汰.

取得樣板容器 (Container) 的資料項目屬性。

GetTemplateContainerDataSource(String)
已淘汰.

取得樣板容器中的資料來源。

(繼承來源 BaseDataListDesigner)
GetTemplateContent(ITemplateEditingFrame, String, Boolean)
已淘汰.

取得樣板的內容。

GetTemplateEditingVerbs()
已淘汰.

取得設計工具可使用的樣板編輯動作。

(繼承來源 TemplatedControlDesigner)
GetTemplateFromText(String)

從指定的文字建立樣板。

(繼承來源 TemplatedControlDesigner)
GetTemplatePropertyParentType(String)
已淘汰.

取得與指定樣板之父代 (Parent) 對應的 Type 物件。

GetTextFromTemplate(ITemplate)

取得表示指定樣板的文字字串。

(繼承來源 TemplatedControlDesigner)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
GetViewRendering()

擷取物件,其中包含關聯控制項之內容和區域的設計階段標記。

(繼承來源 ControlDesigner)
Initialize(IComponent)

使用指定的 DataGrid 控制項以初始化設計工具。

InitializeExistingComponent(IDictionary)

重新初始化現有的元件。

(繼承來源 ComponentDesigner)
InitializeNewComponent(IDictionary)

初始化新建立的元件。

(繼承來源 ComponentDesigner)
InitializeNonDefault()
已淘汰.
已淘汰.

初始化已初始化為預設值以外設定的匯入元件設定。

(繼承來源 ComponentDesigner)
Invalidate()

使設計介面上所顯示之控制項的整個區域失效,並傳送信號給控制項設計工具,要求重繪控制項。

(繼承來源 ControlDesigner)
Invalidate(Rectangle)

使設計介面上所顯示之控制項的指定區域失效,並傳送信號給控制項設計工具,要求重繪控制項。

(繼承來源 ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

取得指定 InheritanceAttributeComponentDesigner

(繼承來源 ComponentDesigner)
InvokePropertyBuilder(Int32)

叫用關聯控制項的元件編輯器。

(繼承來源 BaseDataListDesigner)
IsPropertyBound(String)
已淘汰.

擷取值,指出關聯控制項的指定屬性是否已資料繫結。

(繼承來源 ControlDesigner)
Localize(IDesignTimeResourceWriter)

使用提供的資源寫入器將關聯控制項的可當地語系化屬性保存到設計主應用程式的資源中。

(繼承來源 ControlDesigner)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
OnAutoFormat(Object, EventArgs)
已淘汰.

處理 AutoFormat 事件。

(繼承來源 BaseDataListDesigner)
OnAutoFormatApplied(DesignerAutoFormat)

將自動格式化配置套用至關聯控制項時呼叫。

(繼承來源 BaseDataListDesigner)
OnBehaviorAttached()
已淘汰.

提供一個當行為附加至設計工具時仍可執行其他處理序的機會。

(繼承來源 TemplatedControlDesigner)
OnBehaviorDetaching()
已淘汰.

當行為解除與項目的關聯時呼叫。

(繼承來源 HtmlControlDesigner)
OnBindingsCollectionChanged(String)
已淘汰.

當資料繫結集合變更時呼叫。

(繼承來源 ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

當使用者在設計階段按一下關聯控制項時,由設計主應用程式呼叫。

(繼承來源 ControlDesigner)
OnColumnsChanged()

樣板的資料行變更時會呼叫。

OnComponentChanged(Object, ComponentChangedEventArgs)

在關聯的控制項有變更時呼叫。

(繼承來源 BaseDataListDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

表示將處理關聯控制項之 ComponentChanging 事件的方法。

(繼承來源 ControlDesigner)
OnControlResize()
已淘汰.

於設計階段在設計主應用程式中重新調整關聯之 Web 伺服器控制項的大小時呼叫。

(繼承來源 ControlDesigner)
OnDataSourceChanged()

當關聯控制項的資料來源已經變更時呼叫。

(繼承來源 BaseDataListDesigner)
OnPaint(PaintEventArgs)

CustomPaint 值為 true 的情況下,控制項設計工具在設計介面中繪製關聯的控制項便會呼叫。

(繼承來源 ControlDesigner)
OnPropertyBuilder(Object, EventArgs)

表示處理屬性產生器事件的方法。

(繼承來源 BaseDataListDesigner)
OnSchemaRefreshed()

當關聯控制項的資料來源結構描述變更時呼叫。

(繼承來源 BaseDataListDesigner)
OnSetComponentDefaults()
已淘汰.
已淘汰.

設定元件的預設屬性。

(繼承來源 ComponentDesigner)
OnSetParent()

提供當這個設計工具的父代變更時仍可執行其他處理序的機會。

(繼承來源 TemplatedControlDesigner)
OnStylesChanged()

可加以覆寫,以實作關聯控制項的樣式變更時應該產生的功能。

(繼承來源 BaseDataListDesigner)
OnTemplateEditingVerbsChanged()

當樣板編輯動作變更時會呼叫。

OnTemplateModeChanged()

提供一個當樣板模式變更時仍可執行其他處理序的機會。

(繼承來源 TemplatedControlDesigner)
PostFilterAttributes(IDictionary)

允許設計工具變更或移除它經由 TypeDescriptor 公開的屬性集中的項目。

(繼承來源 ComponentDesigner)
PostFilterEvents(IDictionary)

允許設計工具變更或移除它經由 TypeDescriptor 公開的事件集中的項目。

(繼承來源 ComponentDesigner)
PostFilterProperties(IDictionary)

允許設計工具變更或移除它經由 TypeDescriptor 公開的屬性集中的項目。

(繼承來源 ComponentDesigner)
PreFilterAttributes(IDictionary)

允許設計工具加入至它經由 TypeDescriptor 公開的屬性集。

(繼承來源 ComponentDesigner)
PreFilterEvents(IDictionary)

設定在設計階段公開 (Expose) 的針對元件之 TypeDescriptor 物件的事件清單。

(繼承來源 HtmlControlDesigner)
PreFilterProperties(IDictionary)

供設計工具使用,以便在 [屬性] 方格的顯示中移除屬性或新增屬性,或是遮蔽關聯控制項的屬性。

(繼承來源 BaseDataListDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)

告知 IComponentChangeService 這個元件已經變更。

(繼承來源 ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

告知 IComponentChangeService 這個元件正要變更。

(繼承來源 ComponentDesigner)
RaiseResizeEvent()
已淘汰.

引發 OnControlResize() 事件。

(繼承來源 ControlDesigner)
RegisterClone(Object, Object)

在複製 (Clone) 的控制項中註冊內部資料。

(繼承來源 ControlDesigner)
SaveActiveTemplateEditingFrame()

儲存作用中的樣板編輯框架。

(繼承來源 TemplatedControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)

在設計階段指定控制項之可編輯區域的內容。

(繼承來源 ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

指定控制項之設計階段檢視的可編輯區域內容。

(繼承來源 ControlDesigner)
SetTemplateContent(ITemplateEditingFrame, String, String)
已淘汰.

設定指定樣板和框架的內容。

SetViewFlags(ViewFlags, Boolean)

指派指定的位元 (Bitwise) ViewFlags 列舉型別給指定的旗標值。

(繼承來源 ControlDesigner)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
UpdateDesignTimeHtml()

更新設計階段 HTML。

(繼承來源 TemplatedControlDesigner)

明確介面實作

IDataBindingSchemaProvider.CanRefreshSchema

如需這個成員的說明,請參閱 CanRefreshSchema

(繼承來源 BaseDataListDesigner)
IDataBindingSchemaProvider.RefreshSchema(Boolean)

如需這個成員的說明,請參閱 RefreshSchema(Boolean)

(繼承來源 BaseDataListDesigner)
IDataBindingSchemaProvider.Schema

如需這個成員的說明,請參閱 Schema

(繼承來源 BaseDataListDesigner)
IDesignerFilter.PostFilterAttributes(IDictionary)

如需這個成員的描述,請參閱 PostFilterAttributes(IDictionary) 方法。

(繼承來源 ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

如需這個成員的描述,請參閱 PostFilterEvents(IDictionary) 方法。

(繼承來源 ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

如需這個成員的描述,請參閱 PostFilterProperties(IDictionary) 方法。

(繼承來源 ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

如需這個成員的描述,請參閱 PreFilterAttributes(IDictionary) 方法。

(繼承來源 ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

如需這個成員的描述,請參閱 PreFilterEvents(IDictionary) 方法。

(繼承來源 ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

如需這個成員的描述,請參閱 PreFilterProperties(IDictionary) 方法。

(繼承來源 ComponentDesigner)
ITreeDesigner.Children

如需這個成員的描述,請參閱 Children 屬性。

(繼承來源 ComponentDesigner)
ITreeDesigner.Parent

如需這個成員的描述,請參閱 Parent 屬性。

(繼承來源 ComponentDesigner)

適用於

另請參閱