Usare i moduli per includere i file nella soluzione
In alcuni casi potrebbe essere necessario distribuire file nel server SharePoint indipendentemente dal tipo di file, ad esempio le nuove pagine master. A tale scopo, è possibile usare Moduli (per non confondere con i moduli di codice di Visual Basic). I moduli sono contenitori per i file in una soluzione SharePoint. Quando la soluzione viene distribuita, i file nel modulo vengono copiati nelle cartelle specificate nel server SharePoint.
Elementi e elementi del modulo
Per creare un modulo, aggiungerlo a un progetto scegliendolo nella finestra di dialogo Aggiungi nuovo elemento . Modificare quindi il file Elements.xml in modo da includere i nomi dei file da distribuire, dove si trovano nel sistema e dove devono essere copiati nel server SharePoint.
Di seguito è riportato un esempio del file Elements.xml per un modulo:
<?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>
I moduli appena creati contengono i file predefiniti seguenti:
| Nome del file | Descrizione |
|---|---|
| Elements | File di definizione per il modulo. |
| Sample.txt | File segnaposto che funge da esempio di file nel modulo. |
Il file Elements.xml contiene gli elementi seguenti:
| Nome elemento | Descrizione |
|---|---|
| Elementi | Contiene tutti gli elementi definiti nel modulo. |
| Modulo | L'elemento module ha un singolo attributo, Name, che specifica il nome del modulo nel formato <Module Name="Module1">.Si noti che se si modifica il nome del modulo (o la relativa proprietà Folder Name ), è necessario aggiornare manualmente il nome nell'elemento Module. Se si specifica una sottodirectory per i file nell'elemento Module, Windows SharePoint Services (WSS) creerà automaticamente una struttura di directory corrispondente. |
| file | L'elemento File ha due parametri, Path e Url. - Percorso: nome e percorso del file nella soluzione SharePoint. Il formato è , Path="Module1\Sample.txt".- URL: percorso in cui verrà distribuito il file nel server SharePoint. Il formato è , Url="Module1/Sample.txt".- Tipo: attributo facoltativo con due impostazioni: GhostableInLibrary e Ghostable. Il formato è , Type="GhostableInLibrary". Se si specifica GhostableInLibrary, il file verrà aggiunto a una raccolta documenti in SharePoint insieme a una voce di elenco per accompagnare il file quando viene aggiunto alla raccolta. Se si specifica Ghostable, il file verrà aggiunto a SharePoint all'esterno della raccolta documenti. |
Ogni file da distribuire richiede una voce di elemento separata <File> in Elements.xml.