Creazione di web part per SharePoint

L'utilizzo di Web part, gli utenti possono modificare direttamente il contenuto, l'aspetto e il comportamento delle pagine del sito di SharePoint tramite un browser.Le Web part sono controlli sul lato server eseguiti in un tipo speciale di pagina detta pagina Web part: sono i blocchi predefiniti di pagine visualizzate in un sito di SharePoint.Per ulteriori informazioni sulle Web part in SharePoint, vedere blocco predefinito: Web part.

Visual Studio fornisce modelli utilizzabili per creare ed eseguire il debug delle Web part su un sito di SharePoint.

Creazione di una web part in Visual Studio

Creare una parte Web aggiungendo un elemento Web part a qualsiasi progetto SharePoint.È possibile utilizzare un elemento Web part in una soluzione creata mediante sandbox o una soluzione farm.

Se si desidera progettare visivamente una parte Web utilizzando una finestra di progettazione, creare un progetto Web part visiva o aggiungere un elemento Web part visiva a qualsiasi progetto SharePoint.È possibile utilizzare un elemento Web part visiva solo in una soluzione farm.

Elemento web part

Un elemento Web part fornisce i file che consente di progettare una parte Web per un sito di SharePoint.Quando si aggiunge un elemento Web part, Visual Studio crea una cartella nel progetto e quindi vengono aggiunti alcuni file alla cartella.Nella tabella riportata di seguito viene descritto ogni file.

Per ulteriori informazioni, vedere Procedura: creare una web part di SharePoint.

Elemento web part visiva

Una parte Web visiva è una parte Web creata tramite la finestra di progettazione di Visual Web Developer in Visual Studio.Per ulteriori informazioni su come utilizzare la finestra di progettazione, vedere Visual Studio 11 beta per il mapping del contenuto Web.

Dal punto di vista funzionale, una parte Web visiva non è diversa da una parte del web.Un elemento Web part visiva include un elemento Web part e un elemento Controllo utente.

È possibile progettare l'aspetto della porzione Web o copiando trascinando i controlli da Visual Studio Casella degli strumenti la superficie del controllo utente.Per ulteriori informazioni, vedere Procedura: creare una web part di SharePoint tramite una finestra di progettazione.

Controlli di SharePoint

Visual Studio fornisce alcuni controlli per creare pagine di SharePoint, ad esempio pagine applicazione.Questi controlli vengono visualizzati nella casella degli strumenti in Controlli di SharePoint.La funzionalità per questi controlli deriva Microsoft.SharePoint.WebControls dallo spazio dei nomi, che contiene i controlli server ASP.NET utilizzati nel sito di SharePoint e vengono elencate le pagine.

Debug di una web part

È possibile eseguire il debug di un progetto SharePoint contenente una parte Web procedendo come per altri progetti di Visual Studio.Quando si avvia il debugger di Visual Studio, viene aperto il sito di SharePoint.

Per avviare il debug del codice, aggiungere la parte Web a una pagina Web part in SharePoint.

Per ulteriori informazioni sul debug di progetti SharePoint, vedere Risoluzione dei problemi relativi alle soluzioni SharePoint.

Limitazioni della Web part visiva

A partire da Visual Studio, è possibile aggiungere le Web part visive alle soluzioni create mediante sandbox e le soluzioni farm di SharePoint.Tuttavia, le Web part visive verificano le seguenti limitazioni:

• Le Web part visive non supportano i parametri sostituibili.Per ulteriori informazioni, vedere Parametri sostituibili.

• I controlli utente o le Web part visive non possono essere trascinati e rilasciati o copiati nelle Web part visive.Questa operazione causa un errore di compilazione.

• Le Web part visive non supportano direttamente i token server SharePoint come $SPUrl.Per ulteriori informazioni, vedere “restrizioni relative ai simboli nelle Web part visiva creata mediante sandbox„ nell'argomento Risoluzione dei problemi relativi alle soluzioni SharePoint.

• Le Web part visive in una soluzione creata mediante sandbox che ottengono l'errore, “richiesta sandbox di esecuzione di codice è stata rifiutata poiché il servizio host sandbox di codice è troppo occupato per gestire la richiesta„. Per ulteriori informazioni su questo errore, vedere il post in Blog del team di sviluppo di SharePoint.

• Il debug lato server JavaScript non è supportato in Visual Studio, ma il debug lato client JavaScript è supportato.

  Sebbene sia possibile aggiungere JavaScript inline a un file di markup lato server, il debug non è supportato per i punti di interruzione aggiunti al markup.Per eseguire il debug JavaScript, fare riferimento a un file JavaScript esterni nel file di markup e impostare punti di interruzione nel file JavaScript.

• Esegue il debug del codice inline ASP.NET deve essere eseguito nel file di codice generato anziché nel file di markup.

• Le Web part visive non supportano l'utilizzo della direttiva <@ Assembly Src=.

• I controlli Web di SharePoint e alcuni controlli ASP.NET non sono supportati nell'ambiente sandbox di SharePoint.Se i controlli non supportati sono utilizzati in una parte Web visiva in una soluzione creata mediante sandbox, l'errore, “il tema„ nome dello spazio dei nomi o il tipo non esiste nello spazio dei nomi “Microsoft.SharePoint.WebControls„„.

Per ulteriori informazioni sulle soluzioni create mediante sandbox, vedere Differenze tra soluzioni create mediante sandbox e soluzioni farm.

Creazione di web part basate su SharePoint nello stile di versioni precedenti

È possibile utilizzare i modelli di Visual Studio per creare le Web part personalizzate ASP.NET 2.0 per SharePoint.Le Web part diASP.NET 2.0 si basano sull'infrastruttura della Web part ASP.NET e sono il tipo consigliato per i nuovi progetti.

In pochi casi, potrebbe essere necessario creare una parte Web utilizzando la parte basata su SharePoint web dello stile di versioni precedenti.È possibile utilizzare Visual Studio per creare questi tipi di Web part, ma Visual Studio non sono disponibili modelli che siano progettati appositamente per consentire la creazione.

Per ulteriori informazioni su quando si desidera creare una parte Web basata su SharePoint nello stile di versioni precedenti, Infrastruttura di Web part in Windows SharePoint Servicesvedere.Per ulteriori informazioni su come creare una parte Web tramite la parte Web basata su SharePoint nello stile di versioni precedenti, Procedura dettagliata per creare una Web part di base di SharePointvedere.

Argomenti correlati