SPMobileWebNavigation class

Artigo
05/12/2015

Especifica a identificação do <RenderingTemplate> é usada ao renderizar a área do rodapé de uma home page móvel.

Inheritance hierarchy

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      Microsoft.SharePoint.Mobile.WebControls.SPMobileComponent
        Microsoft.SharePoint.Mobile.WebControls.SPMobileTemplateSelector
          Microsoft.SharePoint.Mobile.WebControls.SPMobileWebTemplateSelector
            Microsoft.SharePoint.Mobile.WebControls.SPMobileWebNavigation

Namespace: Microsoft.SharePoint.Mobile.WebControls
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class SPMobileWebNavigation _
    Inherits SPMobileWebTemplateSelector
'Uso
Dim instance As SPMobileWebNavigation

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class SPMobileWebNavigation : SPMobileWebTemplateSelector

Comentários

Para obter uma visão geral da função dessa classe no sistema de processamento de página para dispositivos móveis, consulte Mobile Page Rendering System.

Não chame SPMobileWebNavigation em seu código. Ela está documentada para fornecer mais compreensão dos móveis como páginas da Web são processadas e como o processamento pode ser personalizado.

Para obter informações sobre o processamento da área de rodapé das páginas que não sejam a home page, consulte SPMobileListNavigation.

A identificação de <RenderingTemplate> possui o seguinte formato.

IntendedPageUse_WebSiteType_PageType_Navigation

Os espaços reservados para IntendedPageUse e WebSiteType são definidos como Mobile Page Rendering System,

O PageType é o tipo de página, como a home page ou NewForm. Para todos os fins práticos, em SharePoint Foundation, essa parte do ID é sempre home page.

"Navegação" indica que <RenderingTemplate> aplica-se à parte do rodapé da página.

O seguinte trecho do arquivo (em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) MobileDefaultTemplates.ascx ) mostra como o SPMobileWebNavigation é chamado pelo modelo de renderização de "MobileHomePageNavigation".

<SharePoint:RenderingTemplate RunAt="Server" ID="MobileHomePageNavigation">
  <Template>
    <SPMobile:SPMobileWebNavigation RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>

O seguinte trecho do mesmo arquivo mostra um dos modelos de processamento interno que podem ser chamados, por sua vez, pelo objeto SPMobileWebNavigation :

<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_Default_HomePage_Navigation">
  <Template>
    <SPMobile:SPMobileHomePageNavigation RunAt="Server" 
       Text="<%$Resources:wss, mobile_navigation_home_text%>"
       AppendWebTitleToText="True" AccessKey="0" />
    <SharePoint:DelegateControl RunAt="server" ControlId="MobileSiteNavigationLink1" />
    <SharePoint:DelegateControl RunAt="server" 
       ControlId="MobileSiteNavigationLink2" />
    <SPMobile:SPMobileLogoutPageNavigation RunAt="Server" 
       Text="<%$Resources:wss, personalactions_logout%>" />
  </Template>
</SharePoint:RenderingTemplate>

Se não for encontrado um modelo com o nome correspondente para um determinado IntendedPageUse e WebSiteType o _Default_HomePage_Navigation IntendedPageUse<RenderingTemplate> é usada.

Não altere MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx. Para qualquer tipo de site da Web, como o STS, que ainda não tiver um <RenderingTemplate> definido em MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx, você pode substituir o _Default_HomePage_Navigation IntendedPageUse<RenderingTemplate> com o seguinte método.

Crie um arquivo. ascx personalizado na pasta ...\CONTROLTEMPLATES que contém um <RenderingTemplate> com o nome IntendedPageUse_WebSiteType_HomePage_Contents. Especifique o nome de um <Template>, como STS (ou a ID de um <Template> para obter uma definição de site personalizada), em vez de WebSiteType. Especifique um uso pretendido de página, como WebPartMobile para IntendedPageUse. Seu personalizado <RenderingTemplate>, em seguida, chama uma combinação de controles diferentes daqueles usados por IntendedPageUse_Default_HomePage_Navigation para processar o rodapé. (Caso contrário, a personalização seria inútil.)

O runtime automaticamente dá preferência a seu personalizado <RenderingTemplate> sobre o _Default_HomePage_Navigation IntendedPageUse<RenderingTemplate> em MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx.

Para obter mais informações sobre como personalizar os rodapés de página da Web, consulte Walkthrough: Customizing the Mobile Home Page.