Procédure : exporter un composant WebPart ASP.NET et l’importer dans un site SharePoint Foundation

Article
09/24/2014

Dernière modification : vendredi 9 avril 2010

S’applique à : SharePoint Foundation 2010

Vous pouvez réutiliser des composants WebPart Microsoft ASP.NET dans votre application Microsoft SharePoint Foundation en les exportant pour créer des fichiers .webpart. Ce sont des fichiers XML qui contiennent des valeurs de propriétés, des données d’état et des détails sur les assemblys ou les fichiers sources relatifs à votre composant WebPart. Comme la fonctionnalité d’exportation n’est pas disponible par défaut, vous devez apporter des modifications au code du composant WebPart et aux paramètres de configuration.

Une fois le fichier .webpart créé, vous pouvez l’importer dans n’importe quelle application SharePoint Foundation. Le composant WebPart s’affiche alors avec l’apparence SharePoint Foundation.

Pour exporter un composant WebPart ASP.NET

Dans le code du composant WebPart, définissez la propriété ExportMode afin de permettre l'exportation des propriétés. Dans le code suivant, affectez à la propriété la valeur All afin de permettre l'exportation des propriétés sensibles.
```
this.ExportMode = WebPartExportMode.All;
```

Modifiez la section <system.web> du fichier web.config de la façon suivante :

<system.web>
   <webparts  enableExport="true" />
<sytem.web>

Dans le menu des composants WebPart, choisissez Export pour créer un fichier .webpart que vous pouvez importer dans une page de site SharePoint Foundation.

Pour importer un fichier .webpart

Placez l’assembly pour votre composant WebPart dans la galerie de solutions, le répertoire Bin ou le Global Assembly Cache.

Si vous placez votre assembly dans la galerie de solutions, votre assembly doit être empaqueté en tant que solution en bac à sable (sandbox) et ne disposera pas d’autorisations de confiance totale. Pour plus d’informations sur les solutions en bac à sable (sandbox), voir Solutions en mode bac à sable.

Si vous placez votre assembly dans le le cache d’assembly global, votre assembly doit avoir un nom fort et s’exécutera avec les autorisations de code de confiance totale par défaut. Le composant WebPart est disponible pour toutes les applications Web. .

Si vous placez votre assembly dans la corbeille, vous n’avez pas besoin de détenir les autorisations de code de confiance totale lors de l’exécution du composant WebPart. Étant donné que les autorisations pour le répertoire Bin sont très faibles par défaut, vous pouvez avoir à créer un nouveau fichier de stratégie de confiance pour votre composant WebPart (recommandé), ou à augmenter le niveau de confiance du fichier web.config (la valeur par défaut est WSS_Minimal). Pour plus d’informations sur la création d’une stratégie de sécurité CAS, voir Sécurisation des composants WebPart dans SharePoint Foundation.
Ajoutez le composant WebPart à la liste des contrôles sans échec de votre fichier web.config, par exemple :
```
<SafeControl 
   Assembly="MyWebPart"
   Namespace="MyWebParts"
   TypeName="*" 
   Safe="True"
/>
```
Accédez à la Galerie de composants WebPart. Sous l’onglet Documents du groupe contextuel Outils de bibliothèque dans le Ruban serveur, cliquez sur le bouton Télécharger un document.
Dans la boîte de dialogue Télécharger un composant WebPart, cliquez sur Parcourir et accédez au fichier .webpart que vous avez créé au cours de la procédure précédente. Cliquez sur OK. Votre composant WebPart apparaît dans la liste des composants WebPart.
Accédez à la page où vous souhaitez que votre composant WebPart apparaisse. Cliquez sur le bouton Modifier sous l’onglet Page du Ruban serveur pour placer la page en mode édition.
Sous l’onglet Insertion du groupe contextuel Outils d’édition, cliquez sur le bouton Composant WebPart.
Dans la liste Catégories, recherchez la catégorie de composants WebPart et choisissez le composant WebPart dans la liste. Cliquez sur Ajouter. Le composant WebPart apparaît dans la page comme dans votre page ASP.NET ; c’est le seul moment où il présente un chrome SharePoint Foundation standard.

Voir aussi

Concepts

Sécurisation des composants WebPart dans SharePoint Foundation

Mise à niveau des composants WebPart

Autres ressources

Développement de composants WebPart dans Windows SharePoint Services

Partager via