SPMobileWebUrlRedirect - Classe

Article
05/12/2015

Spécifie, pour un type particulier de Web (par exemple, BLOG, SharePoint Team Services, SGS ou un type Web personnalisé), l'ID de la <RenderingTemplate> qui identifie le fichier qui sert de page d'accueil du site pour les périphériques mobiles.

Hiérarchie d’héritage

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

Espace de noms : Microsoft.SharePoint.Mobile.WebControls
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class SPMobileWebUrlRedirect _
    Inherits SPMobileWebTemplateSelector
'Utilisation
Dim instance As SPMobileWebUrlRedirect

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

Remarques

L'ID de <RenderingTemplate> a la forme suivante.

Mobile_WebSiteType_PageType_Redirect

Le « Mobile » est un préfixe qui indique que le <RenderingTemplate> est utilisée pour les sites Web mobiles qui n'utilisent pas une page WebParts comme page d'accueil.

Le PageType est le type de page, par exemple la page d'accueil ou NewForm. Mais en général page d'accueil est le seul type de page qui a besoin de rediriger les périphériques mobiles.

La « redirection » indique que <RenderingTemplate> identifie l'URL de la page à laquelle l'appareil mobile doit être redirigé.

La partie WebSiteType de l'ID est déterminée par le SPContext lors de l'instanciation de l'objet SPMobileWebUrlRedirect .

Pour les types de site Web intégré qui livré avec SharePoint Foundation, le WebSiteType est la valeur de l'attribut Name de l'élément CAML (Collaborative Application Markup Language) <Template> (du fichier WEBTEMP.XML SharePoint). Par exemple, la valeur nom de la définition du site blog est « BLOG ». Par conséquent, l'objet SPMobileWebUrlRedirect définit l'ID <RenderingTemplate> suivant pour une page d'accueil de blog mobile.

Mobile_BLOG_HomePage_Redirect

Pour les définitions de site personnalisé, la partie WebSiteType de la <RenderingTemplate>'s ID correspond à la valeur de l'attribut ID de l'élément <Template> (dans un fichier personnalisé WEBTEMP*.XML ), pas l'attribut Name. Supposons que vous disposez d'un fichier WEBTEMPMyCustomSiteDefinitions.XML contenant l'élément <Template>.

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

L'objet SPMobileWebUrlRedirect définit l'ID de <RenderingTemplate> suivant pour la page d'accueil mobile.

Mobile_10001_HomePage_Redirect

Voici la partie du fichier MobileDefaultTemplates.ascx (dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) qui contrôle la redirection des périphériques mobiles.

Notez qu'initialement est appelé la MobileHomePageRedirect <RenderingTemplate>. Elle, à son tour, appelle l'objet SPMobileWebUrlRedirect . Si le contexte est un site de BLOG, l'objet SPMobileWebUrlRedirect définit Mobile_BLOG_HomePage_Redirect comme le suivant <RenderingTemplate> pour appeler et l'appareil mobile est redirigé vers bloghome.aspx. Dans tous les autres cas, s'il n'existe aucune définition de site personnalisé, aucun <RenderingTemplate> avec le _HomePage_Redirect deWebSiteTypede Mobile_ de nom (où WebSiteType est un type de site Web différente de BLOG) se trouve. Donc le <RenderingTemplate> nommé Mobile_Default_HomePage_Redirect est utilisé et il redirige l'appareil mobile vers 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>

S'il existe un fichier *.ascx personnalisé dans le dossier ...\CONTROLTEMPLATES qui contient un <RenderingTemplate> avec le nom Mobile_WebSiteType_HomePage_Redirect (où WebSiteType est le numéro d'identification d'un personnalisé <Template>), la page appelée par ce <RenderingTemplate> va être utilisée.