Procedura: importare una pagina master o un tema
Le pagine master e i temi possono fornire un aspetto coerente alle pagine su un sito di SharePoint. Anche se Visual Studio non fornisce modelli per pagine master o temi, è possibile creare questi elementi in SharePoint Designer e importarli successivamente in Visual Studio. In questo documento viene illustrato come importare pagine master e temi. Per ulteriori informazioni, vedere la pagina relativa al blocco predefinito: pagine e interfaccia utente sul sito Web MSDN.
Per importare una pagina master o un tema
Aprire un progetto SharePoint in Visual Studio.
Se non si dispone di un progetto, è possibile creare un progetto SharePoint vuoto. Per ulteriori informazioni, vedere Modelli di progetto e di elementi di progetto SharePoint.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto, scegliere Aggiungi, quindi fare clic su Nuovo elemento.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Modulo nell'elenco dei modelli di SharePoint. Assegnare un nome al modulo.
Un modulo viene utilizzato come contenitore per la distribuzione di file, ad esempio, file della pagina master o del tema, in un percorso specificato in SharePoint.
Nel modulo eliminare il file Sample.txt predefinito.
Per aggiungere il file della pagina master o del tema al modulo, selezionare il nodo del modulo e nel menu Progetto scegliere Aggiungi elemento esistente. Individuare il file della pagina master o del tema e selezionarlo. L'estensione dei file della pagina master è master mentre quella dei file di tema è thmx.
Se è stata aggiunta una pagina master, impostare la relativa opzione Risoluzione conflitti di distribuzione su Automatica.
Nota
Se il nome della pagina master corrisponde al nome di una pagina master esistente contrassegnata come Pagina master predefinita o Pagina master personalizzata, si possono verificare errori. Per informazioni su come risolvere questo problema, vedere Procedura dettagliata: importazione di una pagina master personalizzata e di una pagina del sito con un'immagine.
Nel modulo fare doppio clic sul file Elements.xml per aprirlo nell'editor.
È necessario aggiornare il file Elements.xml per fare riferimento alla pagina master o al tema aggiunto.
Per una pagina master, sostituire il markup del modulo esistente con quello riportato di seguito.
<Module Name="[Module Name]" Url="_catalogs/masterpage"> <File Path="[Module Name]\[Master Page Name].master" Url="[Master Page Name].master" Type="GhostableInLibrary" /> </Module>Per un tema, sostituire il markup del modulo esistente con quello riportato di seguito.
<Module Name="[Module Name]" Url="_catalogs/theme" <File Path="[Module Name]\[Theme Name].thmx" Url="[Theme Name].thmx" Type="GhostableInLibrary" /> </Module>Assicurarsi di sostituire i valori segnaposto con i nomi effettivi del modulo e della pagina master o del tema.
L'attributo Type="GhostableInLibrary" indica che l'elemento viene aggiunto al database del contenuto mentre l'attributo Url del modulo consente di specificare dove archiviare il file nel database del contenuto SharePoint.
Per modificare l'ambito della distribuzione per la pagina master, in Esplora soluzioni fare doppio clic sul file funzionalità per visualizzarlo nella finestra di progettazione della funzionalità.
Fare clic sulla casella Ambito per specificare l'ambito per la pagina master.
Un valore Web indica che la pagina master si applica solo al sito Web attualmente specificato nel progetto. Un valore Sito indica che la pagina master si applica alla raccolta siti corrente nonché a tutti i siti secondari e alla radice Web. Gli altri valori non sono validi.
Nota
Poiché i temi si applicano solo a livello di raccolta siti, si consiglia di non impostare l'ambito di un tema su un valore diverso da Sito. Se un tema viene utilizzato in un sito secondario, si possono verificare errori.
Scegliere Distribuisci soluzione dal menu Compila.
Per verificare che i file sono stati distribuiti correttamente, aprire il sito di SharePoint.
Scegliere Impostazioni sito nella scheda Azioni sito.
Se è stata aggiunta una pagina master, nella pagina Impostazioni sito fare clic su Pagine master per visualizzare l'elenco delle pagine master. Se è stato aggiunto un tema, nella pagina Impostazioni sito fare clic su Temi per visualizzare l'elenco dei temi. La pagina master o il tema importato deve essere visualizzato nell'elenco.
Vedere anche
Concetti
Importazione di elementi da un sito di SharePoint esistente
Utilizzo di moduli per includere file nella soluzione