SPMobileWebUrlRedirect class

Artigo
05/12/2015

Especifica, para um determinado tipo de Web (por exemplo, BLOG, STS, SGS ou um tipo personalizado de Web), a identificação do <RenderingTemplate> que identifica o arquivo que serve como a homepage do site para dispositivos móveis.

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

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 SPMobileWebUrlRedirect _
    Inherits SPMobileWebTemplateSelector
'Uso
Dim instance As SPMobileWebUrlRedirect

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

Comentários

A identificação de <RenderingTemplate> tem a seguinte forma.

Mobile_WebSiteType_PageType_Redirect

"Mobile" é um prefixo que indica que o <RenderingTemplate> é para sites móveis que não usa uma página de Web Parts como a home page.

O PageType é o tipo de página, como a home page ou NewForm. Mas normalmente a home page é o único tipo de página que precisa redirecionar dispositivos móveis.

"Redirecionar" indica que <RenderingTemplate> identifica o URL da página para que o dispositivo móvel deve ser redirecionado.

A parte WebSiteType do ID é determinada pelo SPContext quando o objeto SPMobileWebUrlRedirect é instanciado.

Para tipos de site internas que vêm com o SharePoint Foundation, o WebSiteType é o valor do atributo Name do elemento Collaborative Application Markup Language (CAML) <Template> (do arquivo de WEBTEMP.XML do SharePoint). Por exemplo, o valor de nome para a definição de site de blog é "BLOG". Portanto, o objeto de SPMobileWebUrlRedirect define a seguinte identificação de <RenderingTemplate> para uma home page do blog móvel.

Mobile_BLOG_HomePage_Redirect

Para obter definições de site personalizadas, a parte WebSiteType do <RenderingTemplate>'s ID é o valor do atributo ID do elemento <Template> (em um arquivo personalizado WEBTEMP*.XML ), não o atributo de nome. Suponha que você tenha um arquivo de WEBTEMPMyCustomSiteDefinitions.XML que contém o seguinte elemento <Template>.

<Template Name="MyFirstCustomSiteDefinition" ID="10001">

O objeto SPMobileWebUrlRedirect define a seguinte identificação de <RenderingTemplate> para a página inicial do mobile.

Mobile_10001_HomePage_Redirect

A seguir é a parte do arquivo (em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) MobileDefaultTemplates.ascx que controla o redirecionamento para dispositivos móveis.

Observe que inicialmente o MobileHomePageRedirect <RenderingTemplate> é chamado. Ele, por sua vez, chama o objeto SPMobileWebUrlRedirect . Se o contexto é um site de BLOG, o objeto SPMobileWebUrlRedirect define Mobile_BLOG_HomePage_Redirect <RenderingTemplate> em seguida chamar e o dispositivo móvel for redirecionado para bloghome.aspx. Em outros casos, se não houver nenhuma definição de site personalizada não <RenderingTemplate> com o nome Mobile_WebSiteType_HomePage_Redirect (onde WebSiteType é um tipo de site que não seja o BLOG) for encontrado. Para que o <RenderingTemplate> chamado Mobile_Default_HomePage_Redirect é usado e ele redireciona o dispositivo móvel para mbllists.aspx.

<SharePoint:RenderingTemplate RunAt="Server" id="MobileHomePageRedirect">
  <Template>
    <SPMobile:SPMobileWebUrlRedirect RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_Default_HomePage_Redirect">
  <Template>
    <SPMobile:SPMobileHomePageRedirection RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_BLOG_HomePage_Redirect">
  <Template>
    <SPMobile:SPMobileHomePageRedirection RunAt="Server" PageFileName="bloghome.aspx" />
  </Template>
</SharePoint:RenderingTemplate>

Se houver um arquivo *. ascx personalizado na pasta ...\CONTROLTEMPLATES que contém um <RenderingTemplate> com o nome Mobile_WebSiteType_HomePage_Redirect (onde WebSiteType é o número de identificação de um personalizado <Template>), a página apontada por esse <RenderingTemplate> será usada.