Partager via

Guide pas à pas : création d'un projet de définition de site de base

  • Article

Ce guide pas à pas vous montre comment créer une définition de site de base qui contient un composant WebPart visuel avec certains contrôles sur celui-ci. Par souci de clarté, le composant WebPart visuel que vous créez n’a que quelques contrôles. Toutefois, vous pouvez créer des définitions de site SharePoint plus sophistiquées qui incluent davantage de fonctionnalités.

Cette procédure pas à pas décrit les tâches suivantes :

  • Création d’une définition de site à l’aide du modèle de projet Visual Studio.

  • Création d’un site SharePoint à l’aide d’une définition de site dans SharePoint.

  • Ajout d’un composant WebPart visuel à la solution.

  • Personnalisation de la page default.aspx du site en y ajoutant le nouveau composant WebPart visuel.

    Notes

    Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

  • Éditions prises en charge de Microsoft Windows et SharePoint. Pour plus d’informations, consultez Configuration requise pour le développement de solutions SharePoint.

  • Visual Studio.

Créer une solution de définition de site

Tout d’abord, créez le projet de définition de site dans Visual Studio.

Créer un projet de définition de site

  1. Dans la barre de menus, choisissez Fichier>Nouveau>Projet. Si votre interface IDE est définie pour utiliser les paramètres de développement Visual Basic, dans la barre de menu, choisissez Fichier>Nouveau projet.

    La boîte de dialogue Nouveau projet apparaît.

  2. Développez le nœud Visual C# ou le nœud Visual Basic, développez le nœud SharePoint, puis choisissez le nœud 2010.

  3. Dans la liste Modèles, sélectionnez le modèle Projet SharePoint 2010.

  4. Dans la zone Nom, entrez TestSiteDef, puis choisissez le bouton OK.

    L’Assistant Personnalisation de SharePoint s’affiche.

  5. Dans la page Spécifier le site et le niveau de sécurité pour le débogage, entrez l’URL du site du serveur SharePoint où vous souhaitez déboguer la définition de site, ou utilisez l’emplacement par défaut (http://System Name/).

  6. Dans la section Quel est le niveau d’approbation de cette solution SharePoint ?, choisissez le bouton d’option Déployer en tant que solution de batterie de serveurs.

    Tous les projets de définition de site doivent être déployés en tant que solutions de batterie de serveurs. Pour plus d'informations sur les solutions bac à sable (sandbox) par rapport aux solutions de batterie, consultez Considérations sur les solutions bac à sable (sandbox).

  7. Cliquez sur le bouton Terminer.

    Le projet apparaît dans l’Explorateur de solutions.

  8. Dans l’Explorateur de solutions, choisissez le nœud de projet, puis, dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.

  9. Sous Visual C# ou Visual Basic, développez le nœud SharePoint, puis sélectionnez le nœud 2010.

  10. Dans le volet Modèles, choisissez le modèle Définition de site, laissez le Nom en tant que SiteDefinition1, puis cliquez sur le bouton Ajouter.

Créer un composant WebPart visuel

Ensuite, créez un composant WebPart visuel à afficher sur la page principale de la définition de site.

Créer un composant WebPart visuel

  1. Dans l’Explorateur de solutions, choisissez l’icône Afficher tous les fichiers.

  2. Choisissez le nœud de projet SiteDefinition1, puis, dans la barre de menu, choisissez Projet>Ajouter un nouvel élément.

    La boîte de dialogue Ajouter un nouvel élément s'affiche.

  3. Développez le nœud Visual C# ou le nœud Visual Basic, développez le nœud SharePoint, puis choisissez le nœud 2010.

  4. Dans la liste des modèles, choisissez le modèle Composant WebPart Visual, conservez le nom par défaut VisualWebPart1, puis choisissez le bouton Ajouter.

    Le fichier VisualWebPart1.ascx s’ouvre.

  5. En bas de VisualWebPart1.ascx, ajoutez le balisage suivant pour ajouter trois contrôles au formulaire : une zone de texte, un bouton et une étiquette :

    <table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

  6. Sous VisualWebPart1.ascx, ouvrez le fichier VisualWebPart1.ascx.cs (pour Visual C#) ou VisualWebPart1.ascx.vb (pour Visual Basic), puis ajoutez le code suivant :

    protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}

    Ce code ajoute des fonctionnalités pour le clic du bouton du composant WebPart.

Ajouter le composant WebPart visuel à la page ASPX par défaut

Ensuite, ajoutez le composant WebPart visuel à la page ASPX par défaut de la définition de site.

Ajouter un composant WebPart visuel à la page ASPX par défaut

  1. Ouvrez la page default.aspx, puis ajoutez la ligne suivante sous la balise WebPartPages :

    <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>

    Cette ligne associe le nom MyWebPartControls au composant WebPart et à son code. Le paramètre Namespace correspond à l’espace de noms utilisé dans le fichier de code VisualWebPart1.ascx.

  2. Après l’élément </asp:Content>, remplacez la section entière ContentPlaceHolderId="PlaceHolderMain" et son contenu par le code suivant :

    <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />
</asp:Content>

    Ce code crée une référence au composant WebPart visuel que vous avez créé précédemment.

  3. Dans l’Explorateur de solutions, ouvrez le menu contextuel du nœud SiteDefinition1, puis choisissez Définir comme élément de démarrage.

Déployer et exécuter la solution de définition de site

Ensuite, déployez le projet sur SharePoint, puis exécutez le projet.

Pour déployer et exécuter la définition de site

  • Dans la barre de menu, choisissez Générer>Déployer TestSiteDef.

  • Choisissez la touche F5.

    Visual Studio compile le code, ajoute ses fonctionnalités, crée un package de tous les fichiers dans un fichier WSP (SharePoint Solution) et déploie le fichier WSP sur SharePoint Server. SharePoint installe ensuite les fichiers, puis active les fonctionnalités.

Créer un site en fonction de la définition du site

Ensuite, créez un site à l’aide de la nouvelle définition de site.

Créer un site à l’aide de la définition de site

  1. Sur le site SharePoint, la page Nouveau site SharePoint s’affiche.

  2. Dans la section Titre et Description, entrez Mon nouveau site pour le titre et une description du site.

  3. Dans la section Adresse du site web,, entrez mynewsite dans la zone Nom de l’URL.

  4. Dans la section Modèle, choisissez l’onglet Personnalisations SharePoint.

  5. Dans la liste Sélectionner un modèle, choisissez SiteDefinition1.

  6. Laissez les autres paramètres à leurs valeurs par défaut, puis choisissez le bouton Créer.

    Le nouveau site s’affiche.

Tester le nouveau site

Ensuite, testez le nouveau site pour vérifier s’il fonctionne correctement.

Tester le nouveau site

  • Dans la page ASPX par défaut, entrez du texte, puis choisissez le bouton Modifier le texte de l’étiquette près de la zone de texte.

    Le texte apparaît dans l’étiquette sur le côté droit du bouton.

Contenu connexe