Cette documentation est archivée et n’est pas conservée.

Procédure : modifier les pages de formulaire et d'affichage de liste mobiles

Windows SharePoint Services 3

Cette rubrique présente une vue d’ensemble de la procédure de base permettant de personnaliser les pages de formulaire et d'affichage de liste Windows SharePoint Services 3.0 accessibles aux périphériques mobiles. Pour une procédure détaillée, voir Procédure pas à pas : personnalisation d'une page mobile d'affichage de liste. Pour une vue d'ensemble de la personnalisation des pages d'accueil de l'affichage mobile, voir Procédure : personnaliser les pages d'accueil de l'affichage mobile.

Comme décrit dans Système de rendu des pages mobiles, les contrôles des zones En-tête (Titre), Contenu et Pied de page (Navigation) d'une page d'accueil de l'affichage mobile démarrent chacun une chaîne d'appels qui aboutit respectivement à des appels des trois contrôles de sélecteur de modèle suivants.

Un objet de l'une de ces classes sélectionne un objet RenderingTemplate en fonction du type de liste actuel (par exemple, Annonces ou un type de liste personnalisé) et le type de page.

Ces contrôles recherchent un ID RenderingTemplate qui présente le format suivant :

Mobile_ IDTypeListe _ TypePage _ ZonePage

IDTypeListe est le numéro d’identification du type de liste actuelle (tel que 105) ou l'une des valeurs de l'énumération SPListTemplateType (telle que Contacts). Un ID de type de liste peut être défini de deux façons :

  • Si la liste est spécifiée dans le cadre du type de site dans le fichier Onet.xml de la définition de site, IDTypeListe est la valeur de l'attribut Type de l'élément List dans Onet.xml. Ce fichier se trouve dans le répertoire suivant : lecteur_local:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\SITETEMPLATES\\xml. (Pour obtenir la liste des numéros d’identification de tous les types de liste fournis avec Windows SharePoint Services 3.0, voir Système de rendu des pages mobiles.)

  • Si la liste a été ajoutée au site dans l'interface utilisateur, autrement dit, la page Nouveau(liste), IDTypeListe est l'ID du type de liste utilisé comme base pour le nouveau type de liste. Cette valeur est déterminée par le lien sur lequel l'utilisateur a cliqué dans la page Créer ( create.aspx) pour accéder à la page Nouveau.

TypePage a pour valeur View, NewForm, EditForm, DispForm ou DeletePage.

ZonePage a pour valeur Title, Contents ou Navigation. (Pour plus d'informations sur les sections d'une page mobile, voir Mise en page et pagination des pages mobiles.)

S'il n'existe aucun élément RenderingTemplate dont l'ID spécifie le type de liste actuel, un élément RenderingTemplate portant un ID d'après le modèle Mobile_Default_TypePage_ZonePage est utilisé.

Pour créer une zone En-tête (Titre), Contenu ou Pied de page (Navigation) personnalisée sur une page de formulaire ou d'affichage de liste mobile, il vous suffit de créer un élément RenderingTemplate portant l'ID recherché par le contrôle de sélecteur de modèle de la zone de page. (Pour plus d'informations, voir la procédure ci-dessous.)

Modèles de rendu existants

La liste suivante identifie les éléments RenderingTemplate des pages de formulaire et d'affichage de liste mobiles incluses dans le fichier MobileDefaultTemplates.ascx installé avec Windows SharePoint Services.

  • Mobile_Comments_DeletePage_Navigation

  • Mobile_Comments_View_Navigation

  • Mobile_DiscussionBoard_DispForm_Contents

  • Mobile_DiscussionBoard_EditForm_Contents

  • Mobile_DiscussionBoard_EditForm_Navigation

  • Mobile_DiscussionBoard_NewForm_Navigation

  • Mobile_DocumentLibrary_View_Navigation

  • Mobile_Events_DispForm_Navigation

  • Mobile_Events_EditForm_Navigation

  • Mobile_Events_NewForm_Navigation

  • Mobile_Events_View_Contents

  • Mobile_Posts_DeletePage_Navigation

  • Mobile_WebPageLibrary_DispForm_Contents

  • Mobile_WebPageLibrary_DispForm_Navigation

Vous ne pouvez pas modifier le fichier MobileDefaultTemplates.ascx. Vous pouvez créer un nouvel élément RenderingTemplate (dans votre propre fichier .ascx) portant le même nom que l'un des éléments existants, mais si vous effectuez cette opération, vous risquez de porter préjudice aux autres solutions déployées dans Windows SharePoint Services qui reposent sur l'élément RenderingTemplate d'origine portant le même nom.

Remarque Remarque :

Les éléments RenderingTemplate fournis avec Windows SharePoint Services 3.0 étant chargés avant les modèles personnalisés, lorsqu'un modèle personnalisé portant le même nom que l'un des modèles de rendu existants est chargé, le modèle personnalisé substitue le modèle d'origine. Si plusieurs objets RenderingTemplate personnalisés portent le même nom, celui dont le nom de fichier occupe la dernière position dans l'ordre alphabétique remplace tous les autres. Si un fichier spécifique possède deux ou plusieurs modèles de rendu portant le même nom, aucun d'eux n'est chargé.

En outre, les éléments RenderingTemplate par défaut suivants sont définis dans le même fichier. Ils sont utilisés par le runtime chaque fois qu'un objet RenderingTemplate pour le type de liste actuel n'est pas défini. Le même risque est présent si vous créez un nouvel objet RenderingTemplate avec l'un de ces noms :

  • Mobile_Default_DeletePage_Contents

  • Mobile_Default_DeletePage_Navigation

  • Mobile_Default_DeletePage_Title

  • Mobile_Default_DispForm_Contents

  • Mobile_Default_DispForm_Navigation

  • Mobile_Default_DispForm_Title

  • Mobile_Default_EditForm_Contents

  • Mobile_Default_EditForm_Navigation

  • Mobile_Default_EditForm_Title

  • Mobile_Default_NewForm_Contents

  • Mobile_Default_NewForm_Navigation

  • Mobile_Default_NewForm_Title

  • Mobile_Default_View_Contents

  • Mobile_Default_View_Navigation

  • Mobile_Default_View_Title

Vous pouvez imbriquer des objets RenderingTemplate. Voir l'exemple ci-dessous.

Pour personnaliser une section d'une page de formulaire ou d'affichage de liste mobile

  1. Dans Microsoft Visual Studio, le Bloc-notes ou un éditeur de texte, créez un fichier de contrôle utilisateur (.ascx) dans le répertoire \Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES.

  2. Pour enregistrer ou importer les espaces de noms appropriés, ajoutez les directives de page nécessaires dans le fichier .ascx.

  3. Ajoutez un modèle de rendu dans le fichier .ascx et attribuez-lui un ID dans le format suivant : Mobile_IDTypeListe_TypePage_ZonePage.

    • IDTypeListe est le numéro d’identification d'un type de la liste actuelle (tel que 105) ou l'une des valeurs de l'énumération SPListTemplateType (telle que Contacts).

    • TypePage peut être View, NewForm, EditForm, DispForm ou DeletePage.

    • ZonePage peut être Title, Contents ou Navigation.

  4. Enregistrez le fichier .ascx et réinitialisez Internet Information Services (IIS) pour que les modifications soient prises en compte.

Exemple

L'exemple suivant d'une définition RenderingTemplate illustre l'imbrication d'objets RenderingTemplate. Pour un exemple de personnalisation d'une page d'affichage de liste, voir Procédure pas à pas : personnalisation d'une page mobile d'affichage de liste.

<SharePoint:RenderingTemplate RunAt="Server" ID="Mobile_104_View_Navigation">
  <Template>
    <mobile:Link RunAt="Server" Text="ASP.NET Website" NavigateUrl="http://www.asp.net" />
    <mobile:Label RunAt="Server" Text="" BreakAfter="True" />
    <SPMobile:SPMobileComponent RunAt="Server" TemplateName="Mobile_Default_View_Navigation" />
  </Template>
</SharePoint:RenderingTemplate>

Voir aussi

Afficher: