Inclure des fichiers à l’aide d’un module
Les modules (à ne pas confondre avec les modules Visual Basic) sont des conteneurs qui vous permettent de déployer des fichiers comme des pages maîtres ASPX, des fichiers texte ou des images sur SharePoint.
Vous pouvez choisir de déployer un fichier dans une bibliothèque de documents ou comme un fichier normal (par exemple, default.aspx) en dehors d’une bibliothèque de documents. Pour ajouter un fichier à une bibliothèque de documents, spécifiez Type="GhostableInLibrary"
comme attribut dans l’élément File. Ce paramètre indique à SharePoint de créer un élément de liste avec votre fichier quand il est ajouté à la bibliothèque. Pour déployer un fichier en dehors d’une bibliothèque de documents, spécifiez Type="Ghostable"
ou omettez simplement l’attribut Type.
Ajouter un module à une solution SharePoint
Pour ajouter un module
Dans Visual Studio, ouvrez ou créez un projet SharePoint.
Pour plus d’informations, consultez Modèles de projet et d’élément de projet SharePoint.
Dans l’Explorateur de solutions, choisissez le nœud du projet, puis, dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.
La boîte de dialogue Ajouter un nouvel élément s’ouvre.
Dans la liste des modèles SharePoint, choisissez le modèle Module, puis le bouton Ajouter.
Cette étape crée un nœud dans le projet nommé Module1.
Sous Module1, supprimez le fichier Sample.txt.
Sample.txt est ajouté à tous les nouveaux modules à titre d’exemple et n’est pas nécessaire. (Notez que la suppression du fichier supprime également son entrée dans le fichier Elements.xml du module.)
Si vous souhaitez que vos fichiers soient déployés dans une structure de dossiers particulière dans SharePoint, créez ces dossiers sous Module1 dans Visual Studio en choisissant le nœud Module1, puis, dans la barre de menus, choisissez Projet, Nouveau dossier.
Choisissez le dossier dans lequel vous souhaitez ajouter le fichier, puis, dans la barre de menus, choisissez Projet, Ajouter un élément existant.
Choisissez un ou plusieurs fichiers que vous souhaitez déployer sur SharePoint, puis choisissez le bouton Ajouter.
Quand vous ajoutez un fichier au projet, l’entrée correspondante est automatiquement ajoutée au fichier Elements.xml du module. Quand le projet est déployé, les fichiers sont copiés sur le serveur SharePoint, par rapport au répertoire racine du projet, qui est spécifié par l’attribut Url de l’élément File, par exemple,
Url="Module1/New Folder/SomeFile.doc
. Si vous souhaitez changer l’emplacement de déploiement d’un fichier, déplacez-le vers un autre dossier dans l’Explorateur de solutions ou changez son paramètre Url.Pour tous les fichiers que vous souhaitez afficher dans une bibliothèque de documents, ajoutez l’attribut
Type="GhostableInLibrary"
à leur entrée dans Elements.xml. Par exemple,<File Path="Module1\Some Folder\SomePage.aspx" Url="Module1/Some Folder/SomePage.aspx" Type="GhostableInLibrary" />
Déployez le projet.
Les fichiers sont copiés vers les emplacements spécifiés dans SharePoint.