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

Articolo
03/12/2013

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

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.

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

Nella barra del menu, scegliere File, Nuovo, Progetto.Se l'ide è configurato per utilizzare le impostazioni di sviluppo di Visual Basic, nella barra dei menu, scegliere File, Nuovo progetto.

Verrà visualizzata la finestra di dialogo Nuovo progetto.
Espandere il nodo Visual C# o il nodo Visual Basic, espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nell'elenco Modelli, scegliere il modello Progetto SharePoint 2010.
Nella casella Nome, immettere TestSiteDef quindi scegliere il pulsante 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 di SharePoint in cui si desidera eseguire il debug della definizione di sito, o utilizzare il percorso predefinito (http://Nome di sistema/).
Nella sezione Selezionare il livello di attendibilità per la soluzione SharePoint., scegliere il pulsante di opzione 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.
Fare clic sul pulsante Fine.

Il progetto viene visualizzato in Esplora soluzioni.
In Esplora soluzioni, selezionare il nodo del progetto, quindi sulla barra dei menu, scegliere Progetto, Aggiungi nuovo elemento.
In Visual C# o Visual Basic, espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nel riquadro Modelli, scegliere il modello Definizione di sito, lasciare Nome come SiteDefinition1quindi scegliere il pulsante Aggiungi.

Creare una web part visiva

Successivamente, creare una Web part visiva da visualizzare nella pagina principale della definizione di sito.

Per creare una web part visiva

In Esplora soluzioni, scegliere il pulsante Mostra tutti i file.
Scegliere il nodo del progetto SiteDefinition1 quindi, nella barra dei menu, scegliere Progetto, Aggiungi nuovo elemento.

Verrà visualizzata la finestra di dialogo Aggiungi nuovo elemento.
Espandere il nodo Visual C# o il nodo Visual Basic, espandere il nodo SharePoint quindi selezionare il nodo 2010.
Nell'elenco di modelli, scegliere il modello Web part visiva, mantenere il nome predefinito VisualWebPart1 quindi scegliere il pulsante Aggiungi.

Il file di VisualWebPart1.ascx viene aperto.

Nella parte inferiore di VisualWebPart1.ascx, aggiungere il markup seguente per aggiungere tre controlli al form: 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>

In VisualWebPart1.ascx, aprire il file di VisualWebPart1.ascx.cs ad Visual C#) o VisualWebPart1.ascx.vb ad Visual Basic) e aggiungere il seguente codice:
```
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 la riga seguente dopo il tag di WebPartPages :
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
Questa riga consente di associare il nome MyWebPartControls alla Web part e al codice.Il parametro di Namespace corrisponda allo spazio dei nomi utilizzato nel file di codice VisualWebPart1.ascx.
Dopo l'elemento di </asp:Content>, sostituire tutta la sezione di ContentPlaceHolderId="PlaceHolderMain" e il relativo contenuto con il codice seguente:
```
<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.
In Esplora soluzioni, scegliere dal menu di scelta rapida del nodo SiteDefinition1 quindi scegliere Imposta elemento di avvio.

Implementare ed eseguire la soluzione di definizione di sito

Successivamente, distribuire il progetto in SharePoint ed eseguire il progetto.

Per distribuire ed eseguire la definizione di sito

Sulla barra dei menu, scegliere Compila, Distribuisci TestSiteDef.
Scegliere il tasto F5.

Visual Studio consente di compilare il codice, aggiungere le relative funzionalità, assemblare tutti i file in un file di soluzione SharePoint (WSP) e le distribuzioni 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, scegliere la scheda Personalizzazioni di SharePoint.
Nell'elenco Selezionare un modello, scegliere SiteDefinition1.
Lasciare le altre impostazioni sui valori predefiniti e quindi scegliere il pulsante Crea.

Viene visualizzato il nuovo sito.

Testare il nuovo sito

Successivamente, testare il nuovo sito per verificare che funzioni correttamente.

Per testare il nuovo sito

Nella pagina ASPX predefinita, digitare un testo e quindi scegliere il pulsante Modifica etichetta testo accanto alla casella di testo.

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

Condividi tramite