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

Article
08/10/2011

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. Pour plus d'informations, consultez Procédure pas à pas : création d'une définition de site avec du contenu supplémentaire.

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.

Notes

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

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 le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet pour ouvrir la boîte de dialogue Nouveau projet.
Développez le nœud SharePoint sous Visual C# ou Visual Basic, cliquez sur SharePoint, puis sur 2010.
Dans le volet Modèles, sélectionnez Définition de site.
Dans la zone Nom, tapez TestSiteDef, puis cliquez sur 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 du serveur SharePoint où vous souhaitez déboguer la définition de site, ou utilisez l'emplacement par défaut (http://nom du système/).
Dans la section Quel est le niveau de confiance de cette solution SharePoint ?, utilisez la valeur par défaut de 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 Terminer. Le projet s'affiche dans l'Explorateur de solutions.

Création d'un composant Visual Web Part

Créez maintenant un composant Visual Web Part afin de l'afficher dans la page principale de définition du site.

Pour créer un composant Visual Web Part

Cliquez sur Ajouter un nouvel élément dans le menu Projet pour afficher la boîte de dialogue Ajouter un nouvel élément.
Cliquez sur le bouton Afficher tous les fichiers dans l'Explorateur de solutions de manière à ce que tous les fichiers s'affichent.
Dans l'arborescence Modèles installés, sélectionnez le nœud Visual Basic ou Visual C#, puis SharePoint, puis 2010, puis cliquez sur Composant Visual Web Part dans la liste des modèles d'élément de projet. Utilisez le nom par défaut VisualWebPart1.

Vous accédez au fichier VisualWebPart1UserControl.ascx.

En bas du fichier VisualWebPart1UserControl.ascx, insérez les balises suivantes afin d'ajouter trois contrôles au formulaire, c'est-à-dire, 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>

Ouvrez le fichier VisualWebPart1UserControl.ascx.cs (pour Visual C#) ou VisualWebPart1UserControl.ascx.vb (pour Visual Basic) situé sous VisualWebPart1UserControl.ascx, 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 et insérez ce qui suit sous la balise WebPartPages :
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.SiteDefinition.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
Cette ligne associe le nom MyWebPartControls au composant Web Part et à son code. Le paramètre Namespace est identique à l'espace de noms utilisé dans le fichier de code VisualWebPart1Usercontrol.ascx.
Après l'élément </asp:Content>, remplacez toute la section ContentPlaceHolderId="PlaceHolderMain" et son contenu par ce qui suit :
```
<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.

Exécution et déploiement de la solution de définition de site

Veuillez à présent exécuter le projet et le déployer sur le site SharePoint.

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

Appuyez sur F5. Visual Studio compile le code, ajoute ses fonctionnalités, empaquette tous les fichiers dans un fichier 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, cliquez sur l'onglet Personnalisations de SharePoint, puis choisissez TestSiteDef dans la liste Sélectionner un mode.
Conservez les valeurs par défaut des autres paramètres, puis cliquez sur Créer.

Le nouveau site apparaît.

Test du nouveau site

Pour finir, testez le nouveau site afin de vous assurer qu'il fonctionne correctement.

Pour tester le nouveau site

Tapez du texte dans la zone de texte de la page ASPX par défaut, puis cliquez sur le petit bouton carré en regard de la zone de texte.

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

Voir aussi

Tâches

Comment : créer un récepteur d'événements

Autres ressources

Procédure pas à pas : création d'une définition de site avec du contenu supplémentaire

Développement de solutions SharePoint

Partager via