GetDesignTimeHtml Method
Collapse the table of content
Expand the table of content

ListControlDesigner.GetDesignTimeHtml Method ()


Gets the HTML that is used to represent the control at design time.

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

public override string GetDesignTimeHtml()

Return Value

Type: System.String

A String containing the markup used to render the control derived from the ListControl at design time.

If the associated control derived from the ListControl object is data-bound, the GetDesignTimeHtml method clears the Items collection and adds a String message indicating the control is data-bound. If the associated control is not data-bound and the Items collection is empty, the GetDesignTimeHtml adds a String message indicating the control is unbound. Then, the GetDesignTimeHtml calls its base method to generate the markup.

The following code example overrides the GetDesignTimeHtml method to customize the markup that is displayed for the associated control on a design surface. If the BackColor property is not defined for the associated control, it is set to Gainsboro, and the control is displayed with that background color. After this is done, the base implementation of the GetDesignTimeHtml method is called.

This code example is part of a larger example provided for the ListControlDesigner class.

// Create the markup to display the control on the design surface. 
public override string GetDesignTimeHtml()
    string designTimeMarkup = null;

    // Create variables to access the control
    // item collection and back color.
    ListItemCollection items = simpleRadioButtonList.Items;
    Color oldBackColor = simpleRadioButtonList.BackColor;

    // Check the property values and render the markup
    // on the design surface accordingly.
        if (oldBackColor == Color.Empty)
            simpleRadioButtonList.BackColor = Color.Gainsboro;

        if (changedDataSource)
            items.Add("Updated to a new data source: " + 
                DataSource + ".");

        // Call the base method to generate the markup.
        designTimeMarkup = base.GetDesignTimeHtml();
    catch (Exception ex)
        // Catch any exceptions that occur.
        designTimeMarkup = GetErrorDesignTimeHtml(ex);
        // Set the properties back to their original state.
        simpleRadioButtonList.BackColor = oldBackColor;

    return designTimeMarkup;
} // GetDesignTimeHtml

.NET Framework
Available since 1.1
Return to top
© 2016 Microsoft