DetailsViewDesigner.GetDesignTimeHtml Method ()

Gets the markup that is used to render the associated control at design time.

Namespace: System.Web.UI.Design.WebControls
Assembly: System.Design (in system.design.dll)

public:
virtual String^ GetDesignTimeHtml () override
public String GetDesignTimeHtml ()
public override function GetDesignTimeHtml () : String
Not applicable.

Return Value

A String containing the markup used to render the DetailsView at design time.

First, the GetDesignTimeHtml method sets the AutoGenerateRows property of the DetailsView control to true, if the Fields collection is empty. The GetDesignTimeHtml then sets the DataKeyNames collection of the GetDesignTimeHtml control to an empty String array if the schema of the data source cannot be obtained. It refreshes the TypeDescriptor object to force the PreFilterProperties method to be called. It then calls the base method to generate the markup.

Notes to Inheritors: If you override the GetDesignTimeHtml method, be sure to call the base method because it eventually, through several override levels, calls on the DetailsView control or a copy of the control to generate the markup.

The following code example shows how to override the GetDesignTimeHtml method in a class inherited from the DetailsViewDesigner class to change the appearance of the DetailsView control at design time. The example adds a new first row to the grid to contain the Caption property, if the Caption is defined. If the BorderStyle property of the control that is derived from DetailsView is the NotSet or None value, the GetDesignTimeHtml draws a blue dashed border around the control to make its extent more visible. It does not change the run-time appearance of the control.

No code example is currently available or this language may not be supported.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: