SPMobilePageNavigation.TemplateName Property
Gets the value of the ID attribute of the <RenderingTemplate> element that defines the rendering of the navigation (footer) area when the control is not on the home page on a mobile Web site.
Namespace: Microsoft.SharePoint.MobileControls
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Overrides ReadOnly Property TemplateName As String
Get
'Usage
Dim instance As SPMobilePageNavigation
Dim value As String
value = instance.TemplateName
public override string TemplateName { get; }
Property Value
Type: System.String
A String that represents the ID of the template for the navigation (footer) area.
Remarks
The following table shows the value of this property for some selected page types of a mobile Web site. This is not a complete list of mobile page types.
Page Type |
Rendering Template |
|---|---|
List View |
"MobileViewNavigation" |
List View in a subfolder |
"MobileViewNavigationWithFolder" |
New Item Form |
"MobileNewFormNavigation" |
Edit Form |
"MobileEditFormNavigation" |
Delete Item Form |
"MobileDeleteNavigation" |
Display Item Form |
"MobileDispFormNavigation" |
Each of these strings is the value of the ID attribute of a <RenderingTemplate> element in the file MobileDefaultTemplates.ascx or GbwMobileDefaultTemplates.ascx located in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\CONTROLTEMPLATES.
You must not modify MobileDefaultTemplates.ascx or GbwMobileDefaultTemplates.ascx. To customize the rendering of a navigation area for a particular page type (such as the List View type), create another <RenderingTemplate> element in a new .ascx file in the ...\CONTROLTEMPLATES folder. Give your new <RenderingTemplate> element an ID value that is descriptive but likely to be unique. For example, you could add your company name to the end of the ID, such as "MobileViewNavigationMyCompanyInc". Then derive a new class from SPMobileComponent, (the same parent as SPMobilePageNavigation) and override its TemplateName property so that it returns your custom ID when the PageType value of the page is PAGE_VIEW. Add an object of the new class to the <FooterTemplate> element of a mobile Web page.
Contrast the TemplateName property with the DefaultTemplateName property, which specifies the <RenderingTemplate> when the page is the home page of the mobile Web site.