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

2025-06-12

Questa procedura dettagliata illustra come creare una definizione di sito di base che contiene una web part visiva con alcuni controlli. Per maggiore chiarezza, la web part visiva creata include solo alcuni controlli. Tuttavia, è possibile creare definizioni di sito di SharePoint più sofisticate che includono più funzionalità.

In questa procedura dettagliata sono illustrati i task seguenti:

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

Nota

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:

Edizioni supportate di Microsoft Windows e SharePoint. Per altre informazioni, vedere Requisiti per lo sviluppo di soluzioni SharePoint.
Visual Studio.

Creare una soluzione di definizione del sito

Creare prima di tutto il progetto di definizione del sito in Visual Studio.

Per creare un progetto di definizione del sito

Nella barra dei menu scegliere File>Nuovo>Progetto. Se l'IDE è impostato per usare 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 e quindi scegliere il nodo 2010 .
Nell'elenco Modelli scegliere il modello progetto di SharePoint 2010.
Nella casella Nome immettere TestSiteDef e quindi scegliere il pulsante OK.

Verrà visualizzata la Personalizzazione guidata SharePoint.
Nella pagina Specificare il sito e il livello di sicurezza per il debug immettere l'URL del sito di SharePoint in cui si vuole eseguire il debug della definizione del sito oppure usare il percorso predefinito (http:// Nome sistema/).
Nella sezione Qual è il livello di attendibilità per questa soluzione SharePoint? scegliere il pulsante di opzione Distribuisci come soluzione farm.

Tutti i progetti di definizione del sito devono essere distribuiti come soluzioni farm. Per altre informazioni sulle soluzioni in modalità sandbox e sulle soluzioni farm, vedere Considerazioni sulle soluzioni in modalità sandbox.
Fare clic sul pulsante Finish .

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

Creare una web part visiva

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

Per creare una web part visiva

In Esplora soluzioni scegliere il pulsante Mostra tutti i file.
Scegliere il nodo del progetto SiteDefinition1 e quindi, sulla 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 e quindi scegliere il nodo 2010 .
Nell'elenco dei modelli scegliere il modello di Web part visuale, mantenere il nome predefinito VisualWebPart1 e quindi scegliere il pulsante Aggiungi .

Verrà aperto il file VisualWebPart1.ascx .

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 VisualWebPart1.ascx.cs (per Visual C#) o VisualWebPart1.ascx.vb (per Visual Basic) e quindi aggiungere il codice seguente:
- C#
- VB
```
protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}
```
```
Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub
```
Questo codice aggiunge funzionalità per il clic del pulsante della web part.

Aggiungere la web part visiva alla pagina ASPX predefinita

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

Per aggiungere una web part visiva alla pagina ASPX predefinita

Aprire la pagina default.aspx e quindi aggiungere la riga seguente sotto il WebPartPages tag :
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
Questa riga associa il nome MyWebPartControls alla web part e al relativo codice. Il parametro Namespace corrisponde allo spazio dei nomi usato nel file di codice VisualWebPart1.ascx .
Dopo l'elemento </asp:Content> , sostituire l'intera ContentPlaceHolderId="PlaceHolderMain" sezione e il relativo contenuto con il codice seguente:
```
<asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />
</asp:Content>
```
Questo codice crea un riferimento alla web part visiva creata in precedenza.
In Esplora soluzioni aprire il menu di scelta rapida per il nodo SiteDefinition1 e quindi scegliere Imposta come elemento di avvio.

Distribuire ed eseguire la soluzione di definizione del sito

Distribuire quindi il progetto in SharePoint e quindi eseguire il progetto.

Per distribuire ed eseguire la definizione di sito

Nella barra dei menu scegliere Compila>Distribuisci TestSiteDef.
Premere F5.

Visual Studio compila il codice, aggiunge le sue funzionalità, inserisce tutti i file in un file di soluzione SharePoint (WSP) e distribuisce il file WSP in SharePoint Server. SharePoint installa quindi i file e quindi attiva le funzionalità.

Creare un sito in base alla definizione del sito

Creare quindi un sito usando la nuova definizione del sito.

Per creare un sito usando la definizione del sito

Nel sito di SharePoint viene visualizzata la pagina Nuovo sito di SharePoint.
Nella sezione Titolo e Descrizione immettere My New Site per il titolo e una descrizione del sito.
Nella sezione Indirizzo sito Web immettere mynewsite nella casella Nome URL.
Nella sezione Modello scegliere la scheda Personalizzazioni di SharePoint.
Nell'elenco Selezionare un modello scegliere SiteDefinition1.
Lasciare i valori predefiniti delle altre impostazioni e quindi scegliere il pulsante Crea .

Viene visualizzato il nuovo sito.

Testare il nuovo sito

Successivamente, testare il nuovo sito per verificare se funziona correttamente.

Per testare il nuovo sito

Nella pagina ASPX predefinita immettere testo e quindi scegliere il pulsante Cambia testo etichetta accanto alla casella di testo.

Il testo viene visualizzato nell'etichetta sul lato destro del pulsante.