Utilizzo di moduli per includere file nella soluzione
Talvolta potrebbe essere utile distribuire file nel server SharePoint indipendentemente dal tipo di file, ad esempio le nuove pagine master. A tal fine, è possibile utilizzare i moduli (che non devono essere confusi con i moduli di codice di Visual Basic). I moduli sono contenitori di file di una soluzione SharePoint. Quando la soluzione viene distribuita, i file del modulo vengono copiati nelle cartelle specificate sul server SharePoint.
Elementi del modulo
Per creare un modulo, aggiungerlo a un progetto selezionandolo nella finestra di dialogo Aggiungi nuovo elemento. Successivamente, modificare il file Elements.xml per includere i nomi dei file che si desidera distribuire, la posizione occupata nel sistema e il punto in cui devono essere copiati nel server SharePoint.
Di seguito è riportato un esempio di file Elements.xml per un modulo:
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
<Module Name="Module1">
<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
</Module>
</Elements>
Nei moduli appena creati sono presenti i seguenti file predefiniti:
Nome file |
Descrizione |
---|---|
Elements.xml |
File di definizione per il modulo. |
Sample.txt |
File segnaposto che funge da esempio di file nel modulo. |
Nel file Elements.xml sono inclusi gli elementi seguenti:
Nome elemento |
Descrizione |
---|---|
Elementi |
Sono contenuti tutti gli elementi definiti nel modulo. |
Modulo |
Dispone di un solo attributo, Name, che specifica il nome del modulo nel formato <Module Name="Module1">.
Nota
Se si modifica il nome del modulo (o la relativa proprietà Folder Name), è necessario aggiornare manualmente il nome nell'elemento Modulo.
Se si specifica una sottodirectory per i file nell'elemento Modulo, Windows SharePoint Services (WSS) consentirà di creare automaticamente una struttura di directory corrispondente per essi. |
File |
Dispone di due parametri, Path e Url.
Nome attributoDescrizione
PercorsoNome e percorso del file nella soluzione SharePoint.Il formato è Path="Module1\Sample.txt".
UrlPosizione nel server SharePoint in cui verrà distribuito il file.Il formato è Url="Module1/Sample.txt".
TypeAttributo facoltativo che dispone di due impostazioni: GhostableInLibrary e Ghostable.Il formato è Type="GhostableInLibrary".Specificando GhostableInLibrary, il file sarà aggiunto a una raccolta documenti in SharePoint insieme a una voce di elenco associata al file quando viene aggiunto alla raccolta.Specificando Ghostable, il file viene aggiunto a SharePoint all'esterno della raccolta documenti.
|
Ogni file che si desidera distribuire richiede una voce di elemento <File> separata in Elements.xml.
Vedere anche
Attività
Procedura: includere file mediante un modulo
Altre risorse
procedura per il provisioning di un file
Sviluppo di soluzioni SharePoint
Creazione di web part per SharePoint
Creazione del pacchetto e distribuzione delle soluzioni SharePoint