This documentation is archived and is not being maintained.

TemplateDefinition Class

Provides properties and methods that define a template element in a Web server control at design time.

System::Object
  System.Web.UI.Design::DesignerObject
    System.Web.UI.Design::TemplateDefinition

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

public ref class TemplateDefinition : public DesignerObject

The TemplateDefinition type exposes the following members.

  NameDescription
Public methodTemplateDefinition(ControlDesigner, String, Object, String)Initializes a new instance of the TemplateDefinition class, using the provided designer, template name, template, and property name.
Public methodTemplateDefinition(ControlDesigner, String, Object, String, Boolean)Initializes a new instance of the TemplateDefinition class, using the provided designer, template name, template, property name, and whether to limit the template contents to Web server controls.
Public methodTemplateDefinition(ControlDesigner, String, Object, String, Style)Initializes a new instance of the TemplateDefinition class, using the provided designer, template name, template, property name, and Style object.
Public methodTemplateDefinition(ControlDesigner, String, Object, String, Style, Boolean)Initializes a new instance of the TemplateDefinition class, using the provided designer, template name, template, property name, Style object, and whether to limit content to Web server controls.
Top

  NameDescription
Public propertyAllowEditingGets a value that indicates whether the template should enable editing of its contents.
Public propertyContentGets or sets the HTML markup representing the content of the template.
Public propertyDesignerGets the associated designer component. (Inherited from DesignerObject.)
Public propertyNameGets the name of the object. (Inherited from DesignerObject.)
Public propertyPropertiesGets the object's properties. (Inherited from DesignerObject.)
Public propertyServerControlsOnlyRetrieves a value indicating whether the template should limit content to Web server controls, as set in the TemplateDefinition constructor. This property is read-only.
Public propertyStyleRetrieves the style that should be applied to the template as set in the TemplateDefinition constructor. This property is read-only.
Public propertySupportsDataBindingRetrieves or sets a value indicating whether the template supports data binding.
Public propertyTemplatedObjectRetrieves the component in which the template resides. This property is read-only.
Public propertyTemplatePropertyNameRetrieves the property name for the template that the design host should display in the property grid.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Protected methodGetServiceGets a service from the design host, as identified by the provided type. (Inherited from DesignerObject.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIServiceProvider::GetServiceFor a description of this member, see IServiceProvider::GetService. (Inherited from DesignerObject.)
Top

The TemplateDefinition class provides a base template definition class that can be inherited from and extended for a control designer to use in providing support for templated controls in a design host such as Visual Studio 2005. A design host uses the properties and methods of the TemplateDefinition class to facilitate creating and editing a template at design time.

The following code example demonstrates how to derive a custom class from the ControlDesigner class. This control designer supports a control with four possible templates.

To try it, add a reference to the System.Design.dll assembly, compile the code, and then, in a design host such as Visual Studio 2005, look at the page in Design view. Select the control, click the action list to select a template to modify, and then use the drag-and-drop feature to move controls into the template.

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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: