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.

File	Descrizione
Elements.xml	Contiene informazioni che il file di definizione della funzionalità nel progetto utilizza per implementare la parte del web.
File con estensione webpart	Fornisce informazioni richieste da SharePoint per visualizzare la parte Web in una raccolta della Web part.
File di codice	Contiene metodi che aggiungono controlli alla parte Web e che generano contenuto personalizzato all'interno della parte del web.

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.

Nome del controllo	Descrizione
AspMenu	Inserisce un menu ASP.Per ulteriori informazioni, vedere Cenni preliminari sul controllo menu.
CssLink	Inserisce un elemento LINK nella pagina aspx e applica uno o più fogli di stile esterni definito da CssRegistration.
DateTimeControl	Inserisce un controllo DateTime nella pagina aspx.
FormDigest	Inserisce una convalida di sicurezza nella pagina aspx
ListProperty	Restituisce una proprietà di un elenco specificato.
ProjectProperty	Restituisce una proprietà globale del sito Web corrente.
RssLink	Inserisce un collegamento a un feed RSS nella pagina aspx.
ScriptLink	Fornisce proprietà e metodi per registrare le risorse, quali script, a una pagina in modo da poter richiedere l'accesso al rendering della pagina.
tema	Applicare un tema alla pagina aspx.

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

Titolo	Descrizione
Procedura: creare una web part di SharePoint	Viene illustrato come creare parti Web per le pagine di SharePoint.
Procedura: creare una web part di SharePoint tramite una finestra di progettazione	Viene illustrato come creare le Web part per SharePoint tramite un'area di progettazione visiva.
Procedura: creare un controllo utente per una web part o una pagina applicazione di SharePoint	Viene illustrato come creare una personalizzata, controlli riutilizzabili che possono essere utilizzati nelle pagine applicazione e nelle Web part eseguite in SharePoint.
Procedura dettagliata: creazione di una web part per SharePoint	Viene descritto come progettare una parte Web di SharePoint.
Procedura dettagliata: creazione di una web part per SharePoint tramite una finestra di progettazione	Viene descritto come progettare una parte Web di SharePoint trascinando i controlli in un'area di progettazione visiva.
Procedura dettagliata: creazione di una Web part Silverlight che visualizza il servizio OData per SharePoint	Viene descritto come progettare una parte Web di SharePoint che ospita un'applicazione Silverlight e visualizzare i dati dagli elenchi di SharePoint.
Utilizzo di Visual Web Developer	Viene descritto come utilizzare la finestra di progettazione visualizzato quando si apre una pagina Web nel progetto.