Création de composants WebPart pour SharePoint

À l'aide de les composants webpart, les utilisateurs peuvent modifier directement le contenu, l'apparence, et le comportement des pages d'un site SharePoint à l'aide d'un navigateur.Les composants webpart sont des contrôles côté serveur qui s'exécutent à l'intérieur d'un type particulier de page appelée une page WebPart : ce sont les blocs de construction des pages qui s'affichent sur un site SharePoint.Pour plus d'informations sur les composants webpart dans SharePoint, consultez Blocs de construction : WebParts.

Visual Studio fournit des modèles que vous pouvez utiliser pour créer et déboguer des composants webpart sur un site SharePoint.

Création d'un composant WebPart dans Visual Studio

Créez composant WebPart en ajoutant un élément Composant WebPart à tout projet SharePoint.Vous pouvez utiliser un élément WebPart dans une solution bac à sable (sandbox) ou une solution de batterie.

Si vous souhaitez concevoir visuellement un composant WebPart à l'aide d'un concepteur, créez un projet Composant visual web part ou ajoutez l'élément Composant visual web part à tout projet SharePoint.Vous ne pouvez utiliser un élément Composant Visual WebPart que dans une solution de batterie.

Élément WebPart

Un élément Composant WebPart fournit les fichiers que vous pouvez utiliser pour concevoir WebPart pour un site SharePoint.Lorsque vous ajoutez un élément Composant WebPart , Visual Studio crée un dossier dans votre projet puis ajoute plusieurs fichiers dans le répertoire.Le tableau suivant décrit chaque fichier.

Fichier	Description
Elements.xml	Contient des informations que le fichier de définition de fonctionnalité dans votre projet utilise pour déployer WebPart.
.webpart	Fournit les informations dont SharePoint a besoin pour afficher votre composant WebPart dans une galerie de composants WebPart.
Fichier de code	Contient les méthodes qui ajoutent des contrôles au composant WebPart et qui génèrent le contenu personnalisé dans WebPart.

Pour plus d’informations, consultez Comment : créer un composant WebPart SharePoint.

Élément Composant Visual WebPart

Composant visual web part est WebPart que vous créez à l'aide de le concepteur Visual Web Developer dans Visual Studio.Pour plus d'informations sur l'utilisation de ce concepteur, consultez Visual Studio 11 bêta du mappage de contenu Web.

Vue fonctionnel, visual web part n'est pas différent du composant WebPart.Un élément Composant Visual WebPart inclus un élément WebPart et un élément Contrôle utilisateur.

Vous pouvez concevoir l'apparence du composant WebPart en faisant glisser ou en copiant les contrôles de Visual Studio Boîte à outils sur la surface du contrôle utilisateur.Pour plus d’informations, consultez Comment : créer un composant WebPart SharePoint à l'aide d'un concepteur.

Contrôles SharePoint

Visual Studio fournit des contrôles pour créer des pages SharePoint, par exemple les pages d'application.Ces contrôles s'affichent dans la boîte à outils sous Contrôles SharePoint.Les fonctionnalités de ces contrôles dérive Microsoft.SharePoint.WebControls de l'espace de noms, qui contient des contrôles serveur ASP.NET qui sont utilisés sur le site SharePoint et répertorient les pages.

Nom du contrôle	Description
AspMenu	Insère un menu d'ASP.NET.Pour plus d'informations, consultez Vue d'ensemble du contrôle menu.
CssLink	Insère un élément d' LINK dans la page .aspx et applique une ou plusieurs feuilles de style externes définies par CssRegistration.
DateTimeControl	Insère un contrôle de date et heure dans la page .aspx.
FormDigest	Insère une validation de sécurité dans la page .aspx
ListProperty	Retourne une propriété d'une liste spécifiée.
ProjectProperty	Retourne une propriété globale du site Web actuel.
RssLink	Insère un lien vers un flux RSS dans la page .aspx.
ScriptLink	Fournit des propriétés et des méthodes pour stocker des ressources, telles que les scripts, sur une page afin qu'elles puissent être demandées lorsque la page s'affiche.
thème	Applique un thème de page .aspx.

Débogage d'un composant WebPart

Vous pouvez déboguer un projet SharePoint qui contient WebPart comme vous le feriez avec d'autres projets Visual Studio.Lorsque vous démarrez le débogueur Visual Studio, Visual Studio ouvre le site SharePoint.

Pour commencer à déboguer votre code, ajoutez le composant WebPart à une page WebPart dans SharePoint.

Pour plus d'informations sur le débogage de projets SharePoint, consultez Dépannage des solutions SharePoint.

Limitations de composant visual web part

À partir de Visual Studio, vous pouvez ajouter des parties visuelles de site Web aux solutions SharePoint et les solutions de batterie bac à sable (sandbox).Toutefois, les parties visuelles de site Web ont les limitations suivantes :

• Les parties visuelles de site Web ne prennent pas en charge les paramètres remplaçables.Pour plus d’informations, consultez Paramètres remplaçables.

• Les contrôles utilisateur ou les parties visuelles de site Web ne peuvent pas être glissés et supprimés ou copiés vers les parties visuelles de site Web.Cette action génère une erreur de build.

• Les parties visuelles de site Web ne prennent pas directement de le serveur SharePoint comme $SPUrl.Pour plus d'informations, consultez « les restrictions symboliques aux composants visual bac à sable (sandbox) » dans la rubrique Dépannage des solutions SharePoint.

• Les parties visuelles de site Web dans une solution bac à sable (sandbox) obtenez parfois l'erreur, « la requête à sable d'exécution de code a été refusée que le service hôte de code bac à sable est trop occupé pour traiter la demande. » Pour plus d'informations sur cette erreur, consultez la publication dans Blog de l'équipe de développement SharePoint.

• Le débogage côté serveur JavaScript n'est pas pris en charge dans Visual Studio, mais le débogage côté client JavaScript en charge.

  Bien que vous puissiez ajouter JavaScript intégré dans un fichier côté serveur de balisage, le débogage n'est pas pris en charge pour les points d'arrêt ajoutés au balisage.Pour déboguer JavaScript, référencez un fichier externe JavaScript dans le fichier de balisage, puis définissez les points d'arrêt dans le fichier JavaScript.

• Le débogage du code intégré d' ASP.NET doit être effectuée dans le fichier de code généré plutôt que dans le fichier de balisage.

• Les parties visuelles de site Web ne prennent pas en charge l'utilisation de la directive d' <@ Assembly Src= .

• Les contrôles Web SharePoint et certains contrôles d' ASP.NET ne sont pas pris en charge dans l'environnement à sable par SharePoint.Si des contrôles non pris en charge sont utilisés dans visual web part dans une solution bac à sable (sandbox), l'erreur, « le thème » de type ou nom de l'espace de noms n'existe pas dans l'espace de noms « Microsoft.SharePoint.WebControls » » s'affiche.

Pour plus d'informations sur les solutions bac à sable (sandbox), consultez Différences entre les solutions bac à sable (sandbox) et les solutions de batterie.

Création de composants WebPart SharePoint de type ancien

Vous pouvez utiliser des modèles dans Visual Studio pour créer des composants personnalisés de site Web d' ASP.NET 2.0 pour SharePoint.Les composants webpart d'ASP.NET 2.0 reposent sur l'infrastructure d' ASP.NET WebPart et sont le type recommandé pour les nouveaux projets.

Dans très peu des cas, vous devrez peut-être créer composant WebPart à l'aide de type ancien WebPart sharepoint sur.Vous pouvez utiliser Visual Studio pour créer ces types de composants webpart, mais Visual Studio ne fournit aucun modèle qui sont conçus spécifiquement pour vous aider à créer.

Pour plus d'informations sur lorsque vous pouvez créer un style ancien WebPart sharepoint sur, consultez Infrastructure WebPart aux Windows SharePoint Services.Pour plus d'informations sur la création de composants WebPart à l'aide de type ancien WebPart sharepoint sur, consultez Procédure pas - à - pas créant un composant WebPart de base SharePoint.

Rubriques connexes

Titre	Description
Comment : créer un composant WebPart SharePoint	Indique comment créer des composants webpart pour les pages SharePoint.
Comment : créer un composant WebPart SharePoint à l'aide d'un concepteur	Indique comment créer des composants webpart pour SharePoint à l'aide d'une aire de conception visuelle.
Comment : créer un contrôle utilisateur pour un composant WebPart ou une page d'application SharePoint	Indique comment créer une personnalisée, les contrôles réutilisables qui peuvent être consommés par des pages d'application et les composants webpart qui s'exécutent dans SharePoint.
Procédure pas à pas : création d'un composant WebPart pour SharePoint	Décrit comment concevoir un composant WebPart pour SharePoint.
Procédure pas à pas : création d'un composant WebPart pour SharePoint à l'aide d'un concepteur	Décrit comment concevoir un composant WebPart pour SharePoint en faisant glisser des contrôles à une aire de conception visuelle.
Procédure pas à pas : création d'un composant WebPart Silverlight qui affiche OData pour SharePoint	Décrit comment concevoir un composant WebPart pour SharePoint qui héberge une application Silverlight et affiche les données des listes SharePoint.
Utilisation de Visual Web Developer	Décrit comment utiliser le concepteur qui s'affiche lorsque vous ouvrez une page Web dans votre projet.