Device Template Support

Device template support is provided as part of the DeviceSpecific/Choice construct. Writing ASP.NET mobile controls that provide device templates is very similar to writing templated ASP.NET server controls. However, keep in mind the following differences that are unique to mobile controls:

• Every mobile control that supports device templates implements the ITemplateable interface. This is a marker interface and has no methods.

• Controls that support device templates must have a default rendering mode so that the control can still render on devices when no device templates are defined or specified.

• Control developers need to decide how to treat device templates during rendering. One behavior is to switch to an exclusively templated mode if any device template is defined and chosen. The control then performs all of its rendering using provided templates. The List control is an example of such a control. Alternatively, a control can use templates in a purely additive process: If a certain template is defined and chosen, it can be used to add to or replace part of the default rendering. The Form control is an example of a control that exhibits this behavior.

• Instead of exposing ITemplate properties, a mobile control has access to a collection of defined templates. The MobileControl base class has two members that can help a control use device templates:

  • The IsTemplated property indicates whether the control has any templates defined and chosen, as shown in the following code example.

    if (mobileControl.IsTemplated)
    {
        return true;
    }
    

  • The GetTemplate method returns the device template of the given name, or null if none is defined. The following example shows how device templates are retrieved and tested for null status.

    public override void CreateDefaultTemplatedUI(bool doDataBind) 
        {
            ITemplate headerTemplate = GetTemplate(Constants.HeaderTemplateTag);
            ITemplate footerTemplate = GetTemplate(Constants.FooterTemplateTag);
            ITemplate scriptTemplate = GetTemplate(Constants.ScriptTemplateTag);
            if (headerTemplate != null)
            {
                _headerContainer = new TemplateContainer();
                headerTemplate.InstantiateIn(_headerContainer);
                _headerContainer.EnablePagination = false;
                Controls.AddAt(0, _headerContainer);
            }
            if (footerTemplate != null)
            {
                _footerContainer = new TemplateContainer();
                footerTemplate.InstantiateIn(_footerContainer);
                _footerContainer.EnablePagination = false;
                Controls.Add(_footerContainer);
            }
            if (scriptTemplate != null)
            {
                _scriptContainer = new TemplateContainer();
                scriptTemplate.InstantiateIn(_scriptContainer);
                _scriptContainer.EnablePagination = false;
            }
        }
    

The following table describes the templates that are available through the Form control. The Form control supports both device-specific and device-independent template sets.

These templates are also available programmatically. For more information, see the Footer property, Header property, and Script property.

See Also

Concepts

Template Sets and Templated Controls

Implementing Templated Rendering

Other Resources

Adding New Device Adapters and Device Support