Procedura dettagliata: creare un progetto di definizione di sito di base

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come creare una definizione di sito di base in cui è contenuta una web part visiva e alcuni relativi controlli. Per garantire una maggior chiarezza, la web part visiva creata dispone solo di alcuni controlli. Tuttavia, è possibile creare definizioni di sito di SharePoint più sofisticate in cui sono incluse più funzionalità. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di una definizione di sito con contenuto aggiuntivo.

In questa procedura dettagliata vengono illustrate le attività seguenti:

Creazione di una definizione di sito tramite il modello di progetto di Visual Studio.
Creazione di un sito di SharePoint tramite l'utilizzo di una definizione di sito in SharePoint.
Aggiunta di una web part visiva alla soluzione.
Personalizzazione della pagina del sito default.aspx tramite l'aggiunta della nuova web part visiva.

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 la 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.

Creazione di una soluzione di definizione di sito

Creare il progetto di definizione di sito in Visual Studio.

Per creare un progetto di definizione di sito

Visualizzare la finestra di dialogo Nuovo progetto selezionando Nuovo nel menu File, quindi facendo clic su Progetto.
Espandere il nodo SharePoint sotto Visual C# o Visual Basic, fare clic su SharePoint, quindi su 2010.
Nel riquadro Modelli selezionare Definizione di sito.
Nella casella Nome digitare TestSiteDef, quindi fare clic su OK.

Viene visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Specificare il sito e il livello di sicurezza per il debug immettere l'URL per il sito del server SharePoint in cui si desidera eseguire il debug della definizione di sito o utilizzare il percorso predefinito (http://nome del sistema/).
Nella sezione Selezionare il livello di attendibilità per la soluzione SharePoint accettare il valore predefinito di Distribuisci come soluzione farm.

Tutti i progetti di definizione di sito devono essere distribuiti come soluzioni della farm. Per ulteriori informazioni sulle differenze tra le soluzioni create mediante sandbox e quelle della farm, vedere Considerazioni sulle soluzioni create mediante sandbox.
Scegliere Fine. Il progetto viene visualizzato in Esplora soluzioni.

Creare una web part visiva

Creare una web part visiva da visualizzare nella pagina principale della definizione di sito.

Per creare una web part visiva

Fare clic su Aggiungi nuovo elemento nel menu Progetto per visualizzare la finestra di dialogo Aggiungi nuovo elemento.
Fare clic sul pulsante Mostra tutti i file in Esplora soluzioni per visualizzare tutti i file.
Nella visualizzazione struttura ad albero Modelli installati selezionare il nodo Visual Basic o Visual C#, quindi scegliere SharePoint, 2010 e infine fare clic su Web part visiva nell'elenco di modelli di elementi di progetto. Utilizzare il nome predefinito VisualWebPart1.

Questa operazione consente di aprire il file VisualWebPart1UserControl.ascx.

Nella parte inferiore di VisualWebPart1UserControl.ascx aggiungere il markup seguente per fornire tre controlli al form, ovvero una casella di testo, un pulsante e un'etichetta:

<table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

Aprire il file VisualWebPart1UserControl.ascx.cs (per Visual C#) o VisualWebPart1UserControl.ascx.vb (per Visual Basic) che si trova sotto VisualWebPart1UserControl.ascx e aggiungere il codice riportato di seguito:
```
Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub
```
```
protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}
```
Questo codice consente di aggiungere funzionalità per il clic sul pulsante della web part.

Aggiungere la web part visiva alla pagina ASPX predefinita

Aggiungere la web part visiva alla pagina ASPX predefinita della definizione di sito.

Per aggiungere una web part visiva alla pagina ASPX predefinita

Aprire la pagina default.aspx e aggiungere quanto riportato di seguito sotto il tag WebPartPages:
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.SiteDefinition.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
Questa riga consente di associare il nome MyWebPartControls alla web part e al codice. Il parametro Namespace è lo stesso spazio dei nomi utilizzato nel file di codice VisualWebPart1Usercontrol.ascx.
Dopo l'elemento </asp:Content>, sostituire tutta la sezione ContentPlaceHolderId="PlaceHolderMain" e il relativo contenuto con quanto riportato di seguito:
```
<asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />    
</asp:Content>
```
Questo codice consente di creare un riferimento alla web part visiva creata precedentemente.

Eseguire e distribuire la soluzione di definizione di sito

Eseguire e distribuire il progetto in SharePoint.

Per eseguire e distribuire la definizione di sito

Premere F5. Visual Studio consente di compilare il codice, aggiungere le relative funzionalità, assemblare tutti i file in un file WSP e distribuire quest'ultimo al server SharePoint. Successivamente, tramite SharePoint, vengono installati i file e attivate le funzionalità.

Creare un sito basato sulla definizione di sito

Creare un sito tramite la nuova definizione di sito.

Per creare un sito tramite la definizione di sito

Sul sito di SharePoint viene visualizzata la pagina Nuovo sito di SharePoint.
Nella sezione Titolo e descrizione immettere Nuovo sito per il titolo e una descrizione del sito.
Nella sezione Indirizzo sito Web immettere nuovosito nella casella Nome URL.
Nella sezione Modello fare clic sulla scheda Personalizzazioni SharePoint, quindi selezionare TestSiteDef nell'elenco Seleziona modello.
Mantenere il valore predefinito delle altre impostazioni, quindi fare clic su Crea.

Viene visualizzato il nuovo sito.

Testare il nuovo sito

Testare il nuovo sito per assicurarsi che funzioni correttamente.

Per testare il nuovo sito

Nella casella di testo della pagina ASPX predefinita immettere un testo, quindi fare clic sul piccolo pulsante quadrato accanto alla casella di testo.

Il testo viene visualizzato nell'etichetta a destra del pulsante.

Vedere anche

Attività

Procedura: creare un ricevitore di eventi

Altre risorse

Procedura dettagliata: creazione di una definizione di sito con contenuto aggiuntivo

Sviluppo di soluzioni SharePoint

Condividi tramite