Partager via


SPMobileWebContents - Classe

Spécifie l'ID de la <RenderingTemplate> qui est utilisé lors du rendu de la zone de contenu principale d'une page d'accueil mobile.

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

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

Syntaxe

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

Remarques

Pour une vue d'ensemble du rôle de cette classe dans le système de rendu de page pour les périphériques mobiles, consultez Mobile Page Rendering System.

N'appelez pas SPMobileWebContents dans votre code. Il est documenté permettant de mieux comprendre des pages Web mobiles sont rendus et comment personnaliser le rendu.

Pour plus d'informations sur le rendu de la zone de contenu principale d'autres pages que la page d'accueil, consultez SPMobileListContents.

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

IntendedPageUse_WebSiteType_PageType_Contents

Les espaces réservés, IntendedPageUse et WebSiteType sont définis comme dans Mobile Page Rendering System,

Le PageType est le type de page, par exemple la page d'accueil ou NewForm. Pour des raisons pratiques, dans SharePoint Foundation, cette partie de l'ID est toujours page d'accueil.

Le « contenu » indique que <RenderingTemplate> s'applique à la partie de contenu principal de la page.

Les extraits suivants à partir du fichier MobileDefaultTemplates.ascx (dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) montre comment le SPMobileWebContents est appelée par le modèle de rendu de « MobileHomePageContents ».

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

L'extrait suivant à partir du même fichier montre certains modèles rendu intégré qui peuvent être appelées par l'objet SPMobileWebContents , à son tour, de :

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

Si un modèle avec le nom correspondant n'est trouvé pour un spécifique IntendedPageUse et WebSiteType les _Default_HomePage_Contents IntendedPageUse<RenderingTemplate> est utilisé. Par exemple, dans le contexte d'un site de BLOG l'objet SPMobileWebContents définit un modèle nommé Mobile_BLOG_HomePage_Contents. Dans la mesure où il n'y a aucun <RenderingTemplate> portant le même nom, le Mobile_Default_HomePage_Contents <RenderingTemplate> est utilisé.

Ne modifiez pas MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx. Pour tout type de site Web, telles que BLOG, qui ne possède pas déjà un <RenderingTemplate> défini dans MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx, vous pouvez substituer le Mobile_Default_HomePage_Contents <RenderingTemplate> avec la méthode suivante.

Créer un fichier *.ascx personnalisé dans le dossier ...\CONTROLTEMPLATES qui contient un <RenderingTemplate> avec le _HomePage_Contents nom IntendedPageUse_WebSiteType. Spécifiez le nom d'un <Template>, telles que BLOG, (ou l'ID d'un <Template> pour une définition de site personnalisée) à la place de WebSiteType. Votre <RenderingTemplate> personnalisé puis appelle une combinaison de contrôles différents de ceux utilisés par IntendedPageUse_Default_HomePage_Contents pour restituer le contenu. (Sinon, la personnalisation serait inutile.)

Le runtime accorde automatiquement la préférence à votre personnalisé <RenderingTemplate> sur le _Default_HomePage_Contents IntendedPageUse<RenderingTemplate> dans MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx.

Pour plus d'informations sur la personnalisation de la page Web contenu principal, reportez-vous à Walkthrough: Customizing the Mobile Home Page.

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

SPMobileWebContents - Membres

Microsoft.SharePoint.Mobile.WebControls - Espace de noms

Autres ressources

Mobile Page Rendering System

WebTemp.xml

Walkthrough: Customizing the Mobile Home Page