Utiliser des modules pour inclure des fichiers dans la solutionUse modules to include files in the solution

Il peut arriver lorsque vous souhaitez déployer les fichiers sur le serveur SharePoint quel que soit leur type de fichier, telles que de nouvelles pages maîtres.There may be times when you may want to deploy files to the SharePoint server regardless of their file type, such as new master pages. Pour ce faire, vous pouvez utiliser Modules (à ne pas confondre avec Visual BasicVisual Basic modules de code).To do this, you can use Modules (not to be confused with Visual BasicVisual Basic code modules). Les modules sont des conteneurs pour les fichiers dans une solution SharePoint.Modules are containers for files in a SharePoint solution. Lorsque la solution est déployée, les fichiers dans le module sont copiés vers les dossiers spécifiés sur le serveur SharePoint.When the solution is deployed, the files in the module are copied to the specified folders on the SharePoint server.

Éléments et les éléments de moduleModule items and elements

Pour créer un module, ajoutez-le à un projet en choisissant dans la ajouter un nouvel élément boîte de dialogue.To create a module, add it to a project by choosing it in the Add New Item dialog box. Ensuite, modifiez son Elements.xml fichier à inclure les noms des fichiers que vous souhaitez déployer, où ils se trouvent sur le système et ils doivent être copiés sur le serveur SharePoint.Then, modify its Elements.xml file to include the names of the files you want to deploy, where they are located on the system, and where they should be copied on the SharePoint server.

Voici un exemple de la Elements.xml fichier d’un module :Here is an example of the Elements.xml file for a module:

<?xml version="1.0" encoding="utf-8"?>  
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">  
    <Module Name="Module1">  
        <File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />  
    </Module>  
</Elements>  

Modules nouvellement créés contiennent les fichiers par défaut suivants :Newly-created modules contain the following default files:

Nom de fichierFile Name DescriptionDescription
Elements.XmlElements.xml Le fichier de définition pour le module.The definition file for the module.
Sample.txtSample.txt Un fichier d’espace réservé qui sert d’exemple d’un fichier dans le module.A placeholder file that serves as an example of a file in the module.

Le Elements.xml fichier contient les éléments suivants :The Elements.xml file contains the following elements:

Nom de l'élémentElement Name DescriptionDescription
ÉlémentsElements Contient tous les éléments définis dans le module.Contains all of the elements defined in the module.
ModuleModule L’élément de module possède un attribut unique, nom, qui spécifie le nom du module dans le format <Module Name="Module1">.The module element has a single attribute, Name, that specifies the name of the module in the format <Module Name="Module1">.

Notez que si vous modifiez le nom du module (ou son nom du dossier propriété), vous devez mettre à jour manuellement le nom dans l’élément de Module.Note that if you change the name of the module (or its Folder Name property), you must manually update the name in the Module element.

Si vous spécifiez un sous-répertoire pour l’ou les fichiers dans l’élément de Module, Windows SharePoint ServicesWindows SharePoint Services (WSS) crée automatiquement une structure de répertoire correspondant pour eux.If you specify a subdirectory for the file(s) in the Module element, Windows SharePoint ServicesWindows SharePoint Services (WSS) will automatically create a matching directory structure for them.
FichierFile L’élément File a deux paramètres, chemin d’accès et Url.The File element has two parameters, Path and Url.

-Chemin d’accès : Le nom et l’emplacement du fichier dans la solution SharePoint.- Path: The name and location of the file in the SharePoint solution. Le format est, Path="Module1\Sample.txt".The format is, Path="Module1\Sample.txt".

-Url : L’emplacement où le fichier sera déployé sur le serveur SharePoint.- Url: The location where the file will be deployed on the SharePoint server. Le format est, Url="Module1/Sample.txt".The format is, Url="Module1/Sample.txt".

-Type : Un attribut facultatif qui a deux paramètres : GhostableInLibrary et Ghostable.- Type: An optional attribute that has two settings: GhostableInLibrary and Ghostable. Le format est, Type="GhostableInLibrary".The format is, Type="GhostableInLibrary". Spécification GhostableInLibrary signifie le fichier est ajouté à une bibliothèque de documents dans SharePoint avec un élément de liste pour accompagner le fichier lorsqu’il est ajouté à la bibliothèque.Specifying GhostableInLibrary means the file will be added to a document library in SharePoint together with a list item to accompany the file when it is added to the library. Spécification Ghostable , le fichier à ajouter à SharePoint en dehors de la bibliothèque de documents.Specifying Ghostable causes the file to be added to SharePoint outside the document library.

Chaque fichier que vous souhaitez déployer nécessite une <File> entrée d’élément dans Elements.xml.Each file that you want to deploy requires a separate <File> element entry in Elements.xml.

Voir aussiSee also

Comment : inclure des fichiers à l’aide d’un module How to: Include files by using a module
Comment : configurer un fichier how to: Provision a file
Développement de solutions SharePoint Developing SharePoint solutions
Création de composants WebPart pour SharePoint Creating web parts for SharePoint
Empaqueter et déployer des solutions SharePointPackage and deploy SharePoint solutions