Partager via

Procédure : créer un composant WebPart qui héberge une application externe

  • Article

Dernière modification : jeudi 1 septembre 2011

S’applique à : SharePoint Foundation 2010

Cette rubrique donne une vue d’ensemble de la création d’un composant WebPart qui héberge une application non-SharePoint, éventuellement une application située dans un domaine différent de l’application Web Microsoft SharePoint Foundation dans laquelle le composant WebPart est utilisé. En règle générale, votre composant WebPart possèdent des propriétés modifiables, auquel cas vous devez également créer un composant ToolPart pour le composant WebPart.

Pour créer le composant WebPart

  1. Dans Microsoft Visual Studio 2010, démarrez un projet SharePoint vide.

  2. Ajoutez un composant WebPart au projet et ouvrez le fichier de code source cs ou vb.

  3. Ajoutez une instruction using (Imports dans Visual Basic) pour l’espace de noms Microsoft.SharePoint.WebPartPages.

  4. Définissez votre classe de composant WebPart comme héritière de la classe ClientApplicationWebPartBase, au lieu du composant WebPart par défaut.

  5. Substituez, si nécessaire, le constructeur de la classe et les méthodes CreateChildControls et RenderContents.

    Si vous souhaitez que votre composant WebPart puisse être utilisé avec un fournisseur d’applications externes (EAP, External Application Provider) personnalisé, votre méthode CreateChildControls doit effectuer les opérations suivantes :

    1. Appeler la méthode GetExternalApplicationRequestResult() héritée.

    2. Appeler la méthode GetInitParams() héritée.

    3. Appeler la méthode GetContentControl(String) de l’objet SPExternalApplicationRequestResult qui est retourné par l’appel à GetExternalApplicationRequestResult(), et lui passer comme paramètre l’objet String qui est retourné par l’appel à GetInitParams().

    Si aucun EAP personnalisé n’a été créé et enregistré avec le service Web qui contient l’application Web, cette série d’appels n’aura aucun effet.

  6. Si le Code XML d’application externe du composant WebPart inclut des propriétés personnalisées, vous devez créer un EAP personnalisé pour les lire. Dans le cadre du processus de création de l’EAP personnalisé, vous implémenterez la méthode OnApplicationWebPartCreateChildControls(SPExternalApplicationRequestProperties). Pour plus d’informations sur la création d’un EAP personnalisé, voir Procédure : créer un fournisseur d’applications externes personnalisées.

  7. Si votre composant WebPart a des propriétés modifiables, implémentez la méthode CreateEditorParts() héritée pour créer un objet de votre classe de composant ToolPart. Pour plus d’informations sur cette classe, voir la procédure Pour créer le composant ToolPart.

Pour créer le composant ToolPart

  1. Ajoutez un autre composant WebPart au projet.

  2. Définissez votre classe comme héritière de la classe EditorPart, au lieu du composant WebPart par défaut.

  3. Ajoutez une implémentation de la méthode SyncChanges() pour lire les propriétés modifiables du composant WebPart dans les contrôles modifiables du composant ToolPart.

  4. Ajoutez une implémentation de la méthode ApplyChanges() pour lire les valeurs des contrôles dans le composant ToolPart et les assigner aux propriétés du composant WebPart.

  5. Substituez, si nécessaire, la méthode CreateChildControls, la méthode RenderContents et les autres membres.