Clase SPMobilePageNavigation

Artículo
05/13/2015

Especifica el identificador del punto de entrada <RenderingTemplate> que se usa cuando se representa el área de navegación (pie de página) de una página Web móvil.

Jerarquía de la herencia

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      Microsoft.SharePoint.Mobile.WebControls.SPMobileComponent
        Microsoft.SharePoint.Mobile.WebControls.SPMobilePageNavigation

Espacio de nombres: Microsoft.SharePoint.Mobile.WebControls
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class SPMobilePageNavigation _
    Inherits SPMobileComponent
'Uso
Dim instance As SPMobilePageNavigation

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

Comentarios

For an overview of the role of this class in the page rendering system for mobile devices, see Mobile Page Rendering System.

Un objeto SPMobilePageNavigation aparece en el elemento <FooterTemplate> de una página Web móvil. Especifica el punto de entrada a la parte relevante del archivo MobileDefaultTemplates.ascx ubicado en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ TEMPLATE\CONTROLTEMPLATES.

Si el tipo de página es la página principal, la propiedad DefaultTemplateName contiene el identificador de la <RenderingTemplate>. Para todos los demás tipos de página, la propiedad TemplateName contiene el identificador de la <RenderingTemplate>.

Ejemplos

En el siguiente extracto de mbllists.aspx, la página de lista de listas de sitios Web móviles, se muestra un objeto SPMobilePageNavigation en uso.

<!-- Page declaration and other matter omitted -->
<SPMobile:SPMobileForm RunAt="Server" PageType="HomePage" Paginate="true">
  <DeviceSpecific>
    <Choice>
      <!-- matter omitted -->
      <FooterTemplate>
        <SPMobile:SPMobileControlContainer RunAt="Server" Weightless="true">
          <SPMobile:SPMobileComponent RunAt="Server" Templatename="MobilePaginateNavigation" />
          <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileDefaultSeparator" />
          <SPMobile:SPMobilePageNavigation RunAt="Server" />
        </SPMobile:SPMobileControlContainer>
      </FooterTemplate>
    </Choice>
  </DeviceSpecific>
  <SPMobile:SPMobilePageContents RunAt="Server" />
</SPMobile:SPMobileForm>

Dado que el tipo de página es una página principal, el valor de la propiedad DefaultTemplateName , "MobileHomePageNavigation", identifica el punto de entrada <RenderingTemplate> MobileDefaultTemplates.ascx. El siguiente fragmento de ese archivo se muestra que el MobileHomePageNavigation <RenderingTemplate> llama a un control SPMobileWebNavigation .

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

The SPMobileWebNavigation control, in turn, simply identifies a more specific <RenderingTemplate> ID: IntendedPageUse_WebSiteType_HomePage_Navigation, where the placeholders IntendedPageUse and WebSiteType are defined as in Mobile Page Rendering System.

Si no hay <RenderingTemplate> con un identificador coincidente existe en algún archivo .ascx en la carpeta ...\CONTROLTEMPLATES , usará el <RenderingTemplate> denominado IntendedPageUse_Default_HomePage_Navigation.

Seguridad para subprocesos

Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.