SPMobileWebContents class

Artigo
05/12/2015

Especifica a identificação do <RenderingTemplate> é usada quando a área de conteúdo principal de uma home page móvel de processamento.

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.SPMobileWebContents

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

Syntax

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

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class SPMobileWebContents : 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 SPMobileWebContents 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 conteúdo principal de páginas que não sejam a home page, consulte SPMobileListContents.

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

IntendedPageUse_WebSiteType_PageType_Contents

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.

O "conteúdo" indica que <RenderingTemplate> se aplica à parte o conteúdo principal da página.

Os trechos abaixo do arquivo MobileDefaultTemplates.ascx (em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) mostra como o SPMobileWebContents é chamado pelo modelo de renderização de "MobileHomePageContents".

<SharePoint:RenderingTemplate RunAt="Server" ID="MobileHomePageContents">
  <Template>
    <SPMobile:SPMobileWebContents RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>

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

<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_Default_HomePage_Contents">
 <Template>
    <SPMobile:SPMobileComponent RunAt="Server" 
       TemplateName="Mobile_STS_HomePage_Contents" 
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" ID="Mobile_STS_HomePage_Contents">
  <Template>
    <SPMobile:SPMobileParentWebControls RunAt="Server" />
    <SPMobile:SPMobileGenericListIterator RunAt="Server" />
    <SPMobile:SPMobileLabel RunAt="Server" 
       Text="<%$Resources:wss, mobile_listcategory_workspaces_text%>" 
       BreakAfter="true" />
    <SPMobile:SPMobileSubWebControls RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>

Se não for encontrado um modelo com o nome correspondente para um determinado IntendedPageUse e WebSiteType o _Default_HomePage_Contents IntendedPageUse<RenderingTemplate> é usada. Por exemplo, no contexto de um site de BLOG o objeto SPMobileWebContents define um modelo chamado Mobile_BLOG_HomePage_Contents. Porque não há nenhum <RenderingTemplate> com esse nome, é usado o Mobile_Default_HomePage_Contents <RenderingTemplate>.

Não altere MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx. Para qualquer tipo de site da Web, como BLOG, que ainda não tiver um <RenderingTemplate> definido em MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx, você pode substituir o Mobile_Default_HomePage_Contents <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 BLOG, (ou a ID de um <Template> para obter uma definição de site personalizada) em vez de WebSiteType. Seu personalizado <RenderingTemplate>, em seguida, chama uma combinação de controles diferentes daqueles usados por IntendedPageUse_Default_HomePage_Contents para processar o conteúdo. (Caso contrário, a personalização seria inútil.)

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

Para obter mais informações sobre como personalizar o conteúdo principal da página da Web, consulte Walkthrough: Customizing the Mobile Home Page.