Procedura dettagliata: importazione di una pagina master personalizzata e di una pagina del sito con un'immagine
In questa procedura dettagliata viene illustrato come importare una pagina master personalizzata di SharePoint e una pagina del sito con un'immagine in un progetto SharePoint per Visual Studio.
In questa procedura dettagliata viene mostrato come completare le attività seguenti:
Creare una pagina master personalizzata e una pagina del sito utilizzando un'immagine in SharePoint Designer.
Esportare una pagina master personalizzata, un'immagine e una pagina del sito in un file (con estensione wsp) della soluzione SharePoint.
Importare e distribuire il file con estensione wsp in un progetto SharePoint per Visual Studio utilizzando il progetto Importa pacchetto di soluzione SharePoint.
Nota
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.
Prerequisiti
Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:
Edizioni supportate di Microsoft Windows e SharePoint. Per ulteriori informazioni, vedere Requisiti per lo sviluppo di soluzioni SharePoint.
Visual Studio 2010.
SharePoint Designer 2010.
Creare elementi in SharePoint Designer
In questo esempio viene mostrato come creare tre elementi in SharePoint Designer per esportare una pagina master personalizzata, una pagina del sito che fa riferimento alla pagina master personalizzata e un file di immagine da visualizzare nella pagina del sito. L'immagine viene aggiunta alla cartella /images/ in SharePoint.
Per creare una pagina master personalizzata in SharePoint Designer
Nel riquadro di spostamento di SharePoint Designer fare clic su Pagine master.
Sulla barra multifunzione fare clic su Pagina master vuota.
Nella parte inferiore di SharePoint Designer fare clic sulla scheda Codice.
Sostituire il markup esistente con quello riportato di seguito.
<%@ Master Language="C#" %> <%@ Register tagprefix="SharePoint" namespace="Microsoft.SharePoint.WebControls" assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <html dir="ltr"> <head runat="server"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <SharePoint:RobotsMetaTag runat="server" __designer:Preview="" __designer:Values="<P N='InDesign' T='False' /><P N='ID' T='ctl00' /><P N='Page' ID='1' /><P N='TemplateControl' ID='2' /><P N='AppRelativeTemplateSourceDirectory' R='-1' />"></SharePoint:RobotsMetaTag> <title>Web Page</title> </head> <body> <form id="form1" runat="server"> <asp:ContentPlaceHolder id="ContentPlaceHolderMain" runat="server"> </asp:ContentPlaceHolder> </form> </body> </html>Salvare la pagina come mybasic1.master.
Aggiungere un'immagine al database del contenuto in SharePoint Designer
È possibile aggiungere un'immagine da visualizzare nella pagina del sito. L'immagine viene distribuita nel database del contenuto SharePoint.
Per aggiungere un'immagine al database del contenuto in SharePoint Designer
Sulla barra multifunzione fare clic su Tutti i file quindi, nella visualizzazione albero, selezionare images.
Sulla barra multifunzione fare clic su Importa file, selezionare un file desiderato, quindi scegliere OK. In questo esempio il file è denominato myimg1.png.
Facoltativamente, è possibile creare una sottocartella per facilitare l'organizzare delle immagini.
Chiudere la finestra di dialogo Importa.
Creare una pagina del sito
In questa pagina del sito di base viene utilizzata la pagina master personalizzata e viene visualizzata l'immagine che è stata aggiunta nel passaggio precedente.
Per creare una pagina del sito
Nel riquadro di spostamento fare clic su Pagine sito.
Sulla barra multifunzione fare clic sul pulsante Pagina, quindi scegliere ASPX. Assegnare al nuovo file il nome mycontentpage1.aspx.
Facoltativamente, è possibile creare una sottocartella per facilitare l'organizzazione delle pagine del sito.
Nell'elenco fare clic su MyContentPage1.aspx per aprire la pagina delle proprietà quindi, nella parte inferiore della pagina, fare clic sul collegamento Modifica.
Fare clic sul pulsante Codice nella parte inferiore della pagina.
Sostituire il markup esistente con quello riportato di seguito.
<%@ Import Namespace="Microsoft.SharePoint.ApplicationPages" %> <%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ Register Tagprefix="asp" Namespace="System.Web.UI" Assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" %> <%@ Import Namespace="Microsoft.SharePoint" %> <%@ Assembly Name="Microsoft.Web.CommandUI, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ Page Language="C#" Inherits="Microsoft.SharePoint.WebControls.LayoutsPageBase" MasterPageFile="../_catalogs/masterpage/mybasic1.master" meta:progid="SharePoint.WebPartPage.Document" %> <asp:Content ID="Main" ContentPlaceHolderID="ContentPlaceHolderMain" runat="server"> <img alt="My Image" longdesc="My image from images folder" src="../images/myimg1.png" /> </asp:Content>Salvare la pagina del sito aggiornata.
Esportare gli elementi da SharePoint
Esportare gli elementi da SharePoint in un file (con estensione wsp) della soluzione SharePoint.
Per esportare elementi da SharePoint Designer
Sulla barra di spostamento in SharePoint Designer fare clic su Sito del team quindi, sulla barra multifunzione, fare clic su Salva come modello.
Nella finestra di dialogo Salva come modello digitare un nome file e un nome del modello, selezionare la casella di controllo Includi contenuto, quindi fare clic su Fine.
In questo modo viene salvato il contenuto del sito nel file con estensione wsp.
Dopo aver esportato la soluzione, fare clic sul collegamento Raccolta soluzioni per visualizzare l'elenco di file di soluzione disponibili.
Fare clic sul nuovo file con estensione wsp e salvarlo nel sistema.
Importare gli elementi in Visual Studio
Importare il file con estensione wsp in Visual Studio. Dopo aver importato il contenuto, è possibile personalizzarlo, aggiungere altri elementi, quindi distribuirlo.
Per importare elementi dal file con estensione wsp in Visual Studio
In Visual Studio creare un progetto Importa pacchetto di soluzione SharePoint.
Nella pagina Selezionare elementi da importare, sotto Modulo nella colonna Tipo selezionare solo i file nella tabella seguente per l'importazione.
Nome file
Descrizione
_catalogsmasterpage_
Pagina master personalizzata.
images_
File di immagine nel file system di SharePoint.
SitePages_
Pagina del sito.
Fare clic su Fine per importare gli elementi selezionati.
In Esplora soluzioni fare clic sulla pagina master personalizzata e impostare la relativa proprietà Risoluzione conflitti di distribuzione su Automatica.
In questo modo tutti i conflitti di distribuzione vengono risolti automaticamente.
Se il nome della nuova pagina master corrisponde a quello di una pagina esistente, verificare che la pagina esistente non sia contrassegnata come Pagina master predefinita o Pagina master personalizzata in SharePoint Designer.
Se una pagina master esistente è contrassegnata come Pagina master predefinita o Pagina master personalizzata, si visualizzerà un errore di distribuzione per indicare che è impossibile eliminare la pagina master. Per evitare questo problema, effettuare le operazioni riportate di seguito.
Se la pagina master esistente è impostata come Pagina master predefinita, impostare temporaneamente un'altra pagina master come Pagina master predefinita. Dopo aver distribuito i file in SharePoint, impostare la nuova pagina master come Pagina master predefinita.
Se la pagina master esistente è impostata come Pagina master personalizzata, impostare temporaneamente un'altra pagina master come Pagina master personalizzata. Dopo aver distribuito i file in SharePoint, impostare la nuova pagina master come Pagina master personalizzata.
Scegliere Distribuisci soluzione dal menu Compila.
Aprire il sito di SharePoint per visualizzare gli elementi distribuiti.
Un modo alternativo per importare file in Visual Studio e distribuirli in SharePoint consiste nell'aggiungere i file in moduli in Visual Studio. Per ulteriori informazioni, vedere Procedura: importare una pagina master o un tema e Utilizzo di moduli per includere file nella soluzione.
Vedere anche
Concetti
Importazione di elementi da un sito di SharePoint esistente
Altre risorse
Sviluppo di soluzioni SharePoint
Creazione di controlli utente riutilizzabili per web part o pagine applicazione