Étape 2 : codage du composant WebPart

Article
09/18/2014

Dernière modification : mardi 20 juillet 2010

S’applique à : SharePoint Server 2010

Cette rubrique montre comment écrire du code qui lance la conversion de document Word Automation Services à l’aide d’un composant WebPart SharePoint Server 2010. Un utilisateur final peut convertir des documents dans la bibliothèque de documents SharePoint spécifiée en cliquant sur un bouton dans un composant WebPart.

Écrire du code pour convertir la bibliothèque de documents

Les procédures suivantes permettent d’ajouter un bouton au composant WebPart et d’ajouter ensuite du code dans l’événement Click du bouton qui lance la conversion de document Word Automation Services.

Pour ajouter un bouton au composant WebPart

Dans le projet Visual Studio 2010 pour l’exemple de solution de composant WebPart, dans l’Explorateur de solutions, développez VisualWebPart1, cliquez avec le bouton droit sur VisualWebPart1UserControl.ascx, puis cliquez sur Concepteur de vues.
À partir de la Boîte à outils, faites glisser un contrôle bouton sur la surface du concepteur.
Avec le bouton sélectionné dans le concepteur, dans Propriétés, double-cliquez sur le champ (ID), tapez btnSubmit, puis appuyez sur Entrée.
Dans Propriétés, faites défiler vers le bas jusqu’à Texte, double-cliquez sur le champ Texte, tapez Conversion de bibliothèque de documents, puis appuyez sur Entrée.

Pour convertir les documents

Avec VisualWebPart1UserControl.ascx ouvert dans le concepteur, assurez-vous que le bouton est sélectionné sur la surface du composant WebPart.
Dans Propriétés, cliquez sur le bouton avec l’icône représentant un éclair pour passer à la vue des événements, puis double-cliquez dans le champ d’événement Clic. Le gestionnaire d’événements btnSubmit_Click est créé dans VisualWebPart1UserControl.ascx.cs.
Dans VisualWebPart1UserControl.ascx.cs, ajoutez une directive d’utilisation pour Word Automation Services.
```
using Microsoft.Office.Word.Server.Conversions;
```
Les principaux objets utilisés pour effectuer la conversion de documents Word Automation Services se trouvent dans l’espace de noms Microsoft.Office.Word.Server.Conversions.
Dans la méthode btnSubmit_Click, ajoutez le code suivant.
```
ConversionJob myJob = new ConversionJob("Word Automation Services");
```
L’argument chaîne passé au constructeur ConversionJob doit être le nom de l’instance de l’application de service pour Word Automation Services, comme décrit dans la rubrique Configuration de Word Automation Services pour le développement. Le nom d’instance de l’application de service est visible sur le page Gérer les applications de service dans l’Administration centrale de SharePoint.
Ensuite, définissez les propriétés sur le ConversionJob en ajoutant le code suivant.
```
myJob.Settings.OutputFormat = SaveFormat.PDF;
   myJob.Settings.OutputSaveBehavior = SaveBehavior.AppendIfPossible;
```
Les deux paramètres dans le code spécifient que :
- Le format de sortie doit être le format PDF.
- Les fichiers de sortie doivent être ajoutés en tant que nouvelle version des fichiers existants lorsque le contrôle de version est activé et remplacer ces fichiers existants dans le cas contraire.
Définissez les informations d’identification à présenter pour exécuter le travail de conversion.

Important

Ce paramètre spécifie que toute lecture ou écriture de documents doit utiliser les informations d’identification de l’utilisateur qui clique sur le bouton. Par défaut, Word Automation Services utilise le contexte anonyme, il est donc important de définir cette propriété.
```
myJob.UserToken = SPContext.Current.Web.CurrentUser.UserToken;
```

Ensuite, spécifiez la bibliothèque d’entrée qui contient les fichiers à convertir, et la bibliothèque de sortie pour les fichiers convertis.

SPWeb myWebSite = SPContext.Current.Web;
   SPList inputLibrary = myWebSite.Lists["Input"];
   SPList outputLibrary = myWebSite.Lists["Output"];
   myJob.AddLibrary(inputLibrary, outputLibrary, true);

Enfin, terminez le code de la méthode btnSubmit_Click en ajoutant le code qui démarre la tâche de conversion Word Automation Services.
```
myJob.Start();
```
Lorsqu’un utilisateur clique sur le bouton du composant WebPart, le code génère un travail de conversion pour les fichiers de la bibliothèque d’entrée.

Voir aussi

Tâches

Étape 1 : configurer le projet Visual Studio 2010 pour la solution de composant WebPart

Étape 3 : générer et déployer la solution WebPart

Concepts

Procédure pas à pas : Création d’un composant WebPart qui utilise Word Automation Services

Partager via