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

Article
03/12/2013

Cette procédure pas à pas montre comment créer une définition de site de base constituée d'un composant Visual Web Part où figurent plusieurs contrôles.Pour des raisons de simplicité, le composant Visual Web Part que vous allez concevoir comportera juste quelques contrôles.Rien ne vous empêche évidemment de créer des définitions de site SharePoint plus sophistiquées mettant en jeu un grand nombre de fonctionnalités.

Cette procédure pas à pas présente 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 en utilisant une définition de site dans SharePoint.
Ajout d'un composant Visual Web Part à la solution.
Personnalisation de la page default.aspx du site en lui ajoutant le nouveau composant Visual Web Part.

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio 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 Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

Éditions de Microsoft Windows et SharePoint prises en charge.Pour plus d'informations, consultez la rubrique Configuration requise pour développer des solutions SharePoint.
Visual Studio.

Création d'une solution de définition de site

Commencez par créer le projet de définition de site dans Visual Studio.

Pour créer un projet de définition de site

Dans la barre de menus, sélectionnez Fichier, Nouveau, Project.Si votre interface IDE est définie pour utiliser les paramètres de développement Visual Basic, dans la barre de menus, sélectionnez Fichier, Nouveau projet.

La boîte de dialogue Nouveau projet s'affiche.
Développez le nœud Visual C# ou le nœud Visual Basic, développez le nœud SharePoint, puis sélectionnez le nœud 2010 .
Dans la liste Modèles, choisissez le modèle Projet SharePoint 2010 .
Dans la zone Nom, entrez TestSiteDef, puis choisissez le bouton OK .

L'Assistant Personnalisation de SharePoint s'affiche.
Dans la page Spécifier le site et le niveau de sécurité pour le débogage, entrez l'URL du site SharePoint où vous souhaitez déboguer la définition de site, ou utilisez l'emplacement par défaut (http://Nom de système/).
Dans la section Quel est le niveau de confiance de cette solution SharePoint ?, sélectionnez la case d'option Déployer en tant que solution de batterie .

Tous les projets de définition de site doivent être déployés comme solutions de batterie.Pour plus d'informations sur les différences entre les solutions bac à sable (sandbox) et les solutions de batterie, consultez Considérations sur les solutions bac à sable (sandbox).
Cliquez sur le bouton Terminer.

Le projet s'affiche dans l'Explorateur de solutions.
Dans Explorateur de solutions, sélectionnez le nœud de projet, puis, dans le menu, choisissez Projet, Ajouter un nouvel élément.
Sous Visual C# ou Visual Basic, développez le nœud SharePoint, puis sélectionnez le nœud 2010 .
Dans le volet de Modèles, choisissez le modèle Définition du site, laissez Nom comme SiteDefinition1, puis choisissez le bouton Ajouter .

Création d'un composant Visual Web Part

Ensuite, créez un composant visual web part à afficher dans la page principale de la définition de site.

Pour créer un composant Visual Web Part

Dans Explorateur de solutions, choisissez le bouton Afficher tous les fichiers .
Sélectionnez le nœud de projet de SiteDefinition1, puis, dans la barre de menus, sélectionnez Projet, Ajouter un nouvel élément.

La boîte de dialogue Ajouter un nouvel élément s'affiche alors.
Développez le nœud Visual C# ou le nœud Visual Basic, développez le nœud SharePoint, puis sélectionnez le nœud 2010 .
Dans la liste des modèles, sélectionnez le modèle Composant Visual Web Part, conservez le nom par défaut VisualWebPart1, puis choisissez le bouton Ajouter .

Le fichier de VisualWebPart1.ascx s'ouvre.

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>

Sous VisualWebPart1.ascx, ouvrez le fichier de VisualWebPart1.ascx.cs (pour Visual C#) ou VisualWebPart1.ascx.vb (pour Visual Basic), puis ajoutez le code suivant :
```
Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub
```
```
protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}
```
Ce code ajoute la fonctionnalité correspondant à l'action de cliquer sur le bouton du composant WebPart.

Ajout du composant Visual Web Part à la page ASPX par défaut

Il convient, à présent, d'ajouter le composant Visual Web Part à la page ASPX par défaut de la définition de site.

Pour ajouter un composant Visual Web Part à la page ASPX par défaut

Ouvrez la page default.aspx, puis ajoutez la ligne suivante dans la balise d' WebPartPages :
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
Cette ligne associe le nom MyWebPartControls avec le composant WebPart et son code.Le paramètre d' Namespace correspond à l'espace de noms utilisée dans le fichier de code de VisualWebPart1.ascx.
Après l'élément d' </asp:Content>, remplacez toute la section d' 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 permet d'associer une référence au composant Visual Web Part que vous avez créé précédemment.
Dans Explorateur de solutions, ouvrez le menu contextuel du nœud SiteDefinition1, puis choisissez Définissez en tant qu'élément de démarrage.

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

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

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

Dans la barre de menus, sélectionnez Build, Déployez TestSiteDef.
Choisissez la touche F5.

Visual Studio compile le code, ajoute ses fonctionnalités, empaquette tous les fichiers dans un fichier de solution SharePoint (WSP), et déploie le fichier WSP sur le serveur SharePoint.SharePoint se charge ensuite d'installer les fichiers et d'activer les fonctionnalités.

Création d'un site basé sur la définition de site

Vous allez maintenant créer un site en vous basant sur la nouvelle définition de site.

Pour créer un site à l'aide de la définition de site

Sur le site SharePoint, la page Nouveau site SharePoint s'affiche.
Dans la section Titre et description, tapez Mon nouveau site en guise de titre et de description du site.
Dans la section Adresse du site Web, entrez monnouveausite dans la zone Nom de l'URL.
Dans la section Modèle, choisissez Personnalisations de SharePoint tableau.
Dans la liste Sélectionner un modèle, choisissez SiteDefinition1.
Laissez les autres paramètres par défaut, puis choisissez le bouton Créer .

Le nouveau site apparaît.

Test du nouveau site

Ensuite, testez le nouveau site pour vérifier si elle fonctionne correctement.

Pour tester le nouveau site

Sur la page ASPX par défaut, entrez du texte, puis choisissez le bouton Remplacez le texte de l'étiquette en regard de la zone de texte.

Le texte s'affiche dans l'étiquette située à droite du bouton.

Partager via