GridViewDesigner Class
Provides design-time support in a visual designer for the GridView control.
Assembly: System.Design (in System.Design.dll)
In a visual designer, when you switch from Source to Design view, the markup source code that describes the GridView control is parsed and a design-time version of the control is created on the design surface. When you switch back to Source view, the design-time control is persisted to the markup source code and edited into the markup for the Web page.
The properties of the GridViewDesigner class provide the following functionality:
The ActionLists property returns a DesignerActionListCollection object, which typically contains an object that is derived from the DesignerActionList class for each level in the inheritance tree of the designer.
The AutoFormats property returns a collection of formatting schemes for display in the Auto Format dialog box.
The TemplateGroups property returns a collection of template groups for the fields of the associated GridView control and the top-level GridView templates.
The UsePreviewControl property always returns true, indicating that the designer creates a temporary copy of the associated GridView to generate the design-time markup.
The methods of the GridViewDesigner class provide the following functionality:
The DataBind method binds the associated GridView control to a design-time data source.
The GetDesignTimeHtml method returns the markup that is used to render the associated GridView at design time.
The Initialize method prepares the designer to view, edit, and design the associated GridView.
The OnClick method is called when a region of the design-time view of the associated GridView is clicked.
The OnSchemaRefreshed method is called when the schema of the data source of the associated GridView changes.
The PreFilterProperties method is used to remove or add properties or to shadow properties of the associated GridView.
Design-time editable regions are not supported in the GridView control, so the GetEditableDesignerRegionContent and SetEditableDesignerRegionContent methods have no functionality.
The following code example shows how to extend the GridViewDesigner class to change the appearance of controls that are derived from the GridView control at design time.
The example derives the MyGridView control from the GridView. The MyGridView is simply a copy of the GridView. The example also derives the MyGridViewDesigner class from the GridViewDesigner class and places a DesignerAttribute object for the MyGridViewDesigner on the MyGridView control.
The MyGridViewDesigner overrides the PreFilterProperties method to make the Page property visible in the Properties grid at design time. It overrides the GetDesignTimeHtml method to include the Caption property, if it is specified, as a new first row in the MyGridView control at design time. If the BorderStyle property of the MyGridView control has the NotSet or None value, the GetDesignTimeHtml draws a blue dashed border around the control to make its extent more visible.
Imports System Imports System.Web Imports System.Drawing Imports System.Web.UI.WebControls Imports System.Web.UI.Design.WebControls Imports System.Collections Imports System.ComponentModel Imports System.Security.Permissions Namespace Examples.VB.WebControls.Design ' The MyGridView is a copy of the GridView. <AspNetHostingPermission(SecurityAction.Demand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermission(SecurityAction.InheritanceDemand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ <Designer(GetType(Examples.VB.WebControls.Design.MyGridViewDesigner))> _ Public Class MyGridView Inherits GridView End Class ' MyVBGridView ' Override members of the GridViewDesigner. <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _ Public Class MyGridViewDesigner Inherits GridViewDesigner ' Shadow the control properties with design-time properties. Protected Overrides Sub PreFilterProperties( _ ByVal properties As IDictionary) ' Call the base method first. MyBase.PreFilterProperties(properties) ' Make the Page visible in the Properties grid. Dim selectProp As PropertyDescriptor = _ CType(properties("Page"), PropertyDescriptor) properties("Page") = _ TypeDescriptor.CreateProperty(selectProp.ComponentType, _ selectProp, BrowsableAttribute.Yes) End Sub ' PreFilterProperties ' Generate the design-time markup. Private Const capTag As String = "caption" Private Const trOpen As String = "tr><td colspan=9 align=center" Private Const trClose As String = "td></tr" Public Overrides Function GetDesignTimeHtml() As String ' Make the full extent of the control more visible in the designer. ' If the border style is None or NotSet, change the border to ' a wide, blue, dashed line. Include the caption within the border. Dim myGV As MyGridView = CType(Component, MyGridView) Dim markup As String = Nothing Dim charX As Integer ' Check if the border style should be changed. If (myGV.BorderStyle = BorderStyle.NotSet Or _ myGV.BorderStyle = BorderStyle.None) Then Dim oldBorderStyle As BorderStyle = myGV.BorderStyle Dim oldBorderWidth As Unit = myGV.BorderWidth Dim oldBorderColor As Color = myGV.BorderColor ' Set the design-time properties and catch any exceptions. Try myGV.BorderStyle = BorderStyle.Dashed myGV.BorderWidth = Unit.Pixel(3) myGV.BorderColor = Color.Blue ' Call the base method to generate the markup. markup = MyBase.GetDesignTimeHtml() Catch ex As Exception markup = GetErrorDesignTimeHtml(ex) Finally ' Restore the properties to their original settings. myGV.BorderStyle = oldBorderStyle myGV.BorderWidth = oldBorderWidth myGV.BorderColor = oldBorderColor End Try Else ' Call the base method to generate the markup. markup = MyBase.GetDesignTimeHtml() End If ' Look for a <caption> tag. charX = markup.IndexOf(capTag) If charX > 0 Then ' Replace the first caption with ' "tr><td colspan=9 align=center". ' It is okay if the colspan exceeds the ' number of columns in the table. markup = markup.Remove(charX, _ capTag.Length).Insert(charX, trOpen) ' Replace the second caption with "td></tr". charX = markup.IndexOf(capTag, charX) If charX > 0 Then markup = markup.Remove(charX, _ capTag.Length).Insert(charX, trClose) End If End If Return markup End Function ' GetDesignTimeHtml End Class ' MyGridViewDesigner End Namespace ' Examples.VB.WebControls.Design
System.ComponentModel.Design.ComponentDesigner
System.Web.UI.Design.HtmlControlDesigner
System.Web.UI.Design.ControlDesigner
System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner
System.Web.UI.Design.WebControls.DataBoundControlDesigner
System.Web.UI.Design.WebControls.GridViewDesigner
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.