Export (0) Print
Expand All

TemplateBasedControl.DefaultTemplateName Property

Gets the name of the default rendering template.

Namespace:  Microsoft.SharePoint.WebControls
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No

protected virtual string DefaultTemplateName { get; }

Property Value

Type: System.String
A String object that names a rendering template.

Notes to Inheritors

The default implementation always returns a null reference (Nothing in Visual Basic).

In typical derived classes, the DefaultTemplateName property contains the value of the ID attribute of a <RenderingTemplate> element in an .ascx file that is located in the following folder:

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\template\controltemplates

The ID attribute identifies the RenderingTemplate object that can be used as a fallback template if the TemplateName property has not been set or, if for any reason, the template it names cannot be used.

For readability and consistency with other classes that are derived from the TemplateBasedControl class, avoid using the DefaultTemplateName property to identify a template that you want to use in special contexts, such as on particular forms. Instead, use the AlternateTemplateName property.

The following is an example of an override of the DefaultTemplateName property. For the full example, see Walkthrough: Creating a Custom Field Type.

protected override string DefaultTemplateName
        return "ISBNFieldControl";
© 2014 Microsoft