SPMobileListContents - Classe

Article
05/12/2015

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

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.SPMobileListTemplateSelector
            Microsoft.SharePoint.Mobile.WebControls.SPMobileListContents

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 SPMobileListContents _
    Inherits SPMobileListTemplateSelector
'Utilisation
Dim instance As SPMobileListContents

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

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 SPMobileListContents dans votre code. Il est documenté permettant de mieux comprendre des pages Web mobiles sont rendus et comment personnaliser le rendu.

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

IntendedListUse_ListTemplateID_PageType_Contents

Les espaces réservés, IntendedListUse, ListTemplateIDet PageType sont définis dans Mobile Page Rendering System.

Le « contenu » indique que <RenderingTemplate> doit s'appliquer à la partie de la zone de contenu principale de la page.

Par conséquent, l'objet SPMobileListContents pour une page en mode liste annonces sur un site Web mobile est la suivante.

Mobile_104_View_Contents

Sinon, il pourrait être le suivant.

Mobile_Announcements_View_Contents

L'extrait suivant du fichier MobileDefaultTemplates.ascx (dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\CONTROLTEMPLATES) montre le balisage qui contrôle le rendu des zones de contenu principales lorsque le type de page est l'affichage. Notez qu'il existe un modèle spécifique pour que le type de liste d'événements. Tous les autres types de liste utilisent la Mobile_Default_View_Contents <RenderingTemplate>.

<SharePoint:RenderingTemplate RunAt="Server" id="MobileViewContents">
  <Template>
    <SPMobile:SPMobileListContents RunAt="Server" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_Default_View_Contents">
  <Template>
    <SPMobile:SPMobileControlContainer RunAt="Server">
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileViewPicker" />
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileDefaultSeparator" />
    </SPMobile:SPMobileControlContainer>
    <SPMobile:SPMobileListItemIterator RunAt="Server" ListItemSeparatorTemplateName="MobileListItemSeparator" />
    <SPMobile:SPMobileLabel RunAt="Server" Text="" Weightless="true" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="Mobile_Events_View_Contents">
  <Template>
    <SPMobile:SPMobileControlContainer  RunAt="Server">
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileViewPicker" />
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileDefaultSeparator" />
    </SPMobile:SPMobileControlContainer>
    <SPMobile:SPMobileEventsListItemIterator RunAt="Server" ListItemSeparatorTemplateName="MobileListItemSeparator" />
    <SPMobile:SPMobileLabel RunAt="Server" Text="" Weightless="true" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="MobileThumbnailViewContents">
  <Template>
    <SPMobile:SPMobileControlContainer RunAt="Server">
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileViewPicker" />
      <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileDefaultSeparator" />
    </SPMobile:SPMobileControlContainer>
    <SPMobile:SPMobileThumbnailViewListItemIterator RunAt="Server" />
    <SPMobile:SPMobileLabel RunAt="Server" Text="" />
  </Template>
</SharePoint:RenderingTemplate>
<SharePoint:RenderingTemplate RunAt="Server" id="MobileSimpleViewContents">
  <Template>
    <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileViewContents" />
  </Template>
</SharePoint:RenderingTemplate>

Ne modifiez pas MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx. N'importe quelle combinaison de type de page (autre que la page d'accueil ou une page personnalisée) et le type de liste qui ne possède pas déjà un <RenderingTemplate> défini dans MobileDefaultTemplates.ascx ou GbwMobileDefaultTemplates.ascx, vous pouvez substituer le _Contents dePageTypeMobile_Default_ <RenderingTemplate> avec les étapes suivantes. (Pour le rendu de la zone de contenu principale sur les pages d'accueil, voir SPMobileWebContents. Pour le rendu de la zone de contenu principale sur les types de page personnalisée, voir SPMobilePageContents).

Créez un fichier .ascx personnalisé dans le dossier ...\CONTROLTEMPLATES qui contient un <RenderingTemplate> avec le _Contents nom Mobile_ListTemplateID_PageType. Permet de spécifier le Type ou le nom d'un <ListTemplate> à la place de ListTemplateID. Spécifiez également un particulier PageType. Ce dernier doit être une des valeurs suivantes: « DeletePage », « DispForm », « EditForm », « NewForm » ou « Vue ». Votre <RenderingTemplate> personnalisé puis appelle une combinaison de contrôles différents de ceux utilisés par _Contents dePageTypeMobile_Default_ pour le rendu de la zone de contenu principale. (Sinon, la personnalisation serait inutile.)

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

Pour plus d'informations sur la personnalisation de la page Web des zones de contenu principales pour les types de page intégré SharePoint Foundation autres que les pages d'accueil, consultez Walkthrough: Customizing a Mobile List View Page.