Condividi tramite

Creare web part per SharePoint

  • Articolo

Utilizzando web part, è possibile modificare il contenuto, l'aspetto e il comportamento delle pagine di un sito di SharePoint tramite un browser. Le web part sono controlli lato server che vengono eseguiti all'interno di una pagina web part: sono i blocchi predefiniti delle pagine visualizzate in un sito di SharePoint. Vedere Blocco predefinito: Web part.

È possibile creare ed eseguire il debug di web part in un sito di SharePoint usando modelli di Visual Studio.

Creare una web part in Visual Studio

Creare una web part aggiungendo un elemento web part a qualsiasi progetto di SharePoint. È possibile usare un elemento della web part in una soluzione in modalità sandbox o in una soluzione farm.

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

Elemento web part

Un elemento della web part fornisce file che è possibile utilizzare per progettare una web part per un sito di SharePoint. Quando si aggiunge un elemento della web part , Visual Studio crea una cartella nel progetto e quindi aggiunge diversi file alla cartella. La tabella seguente descrive ogni file.

File Descrizione
Elements Contiene informazioni usate dal file di definizione delle funzionalità nel progetto per distribuire la web part.
File con estensione webpart Fornisce informazioni che SharePoint deve visualizzare la web part in una raccolta web part.
File di codice Contiene metodi che aggiungono controlli alla web part e che generano contenuto personalizzato all'interno della web part.

Per altre informazioni, vedere Procedura: Creare una web part di SharePoint.

Elemento web part visivo

Una web part visiva è una web part creata usando la finestra di progettazione visuale per sviluppatori Web in Visual Studio. Una web part visiva funziona come qualsiasi altra web part. Per aggiungere controlli, ad esempio pulsanti e caselle di testo, a una web part, aggiungere codice a un file XML. Tuttavia, è possibile aggiungere controlli a una web part visiva trascinandoli o copiandoli nella web part dalla casella degli strumenti di Visual Studio. La finestra di progettazione genera quindi il codice necessario nel file XML. Vedere Procedura: Creare web part di SharePoint tramite una finestra di progettazione.

Controlli di SharePoint

Visual Studio fornisce alcuni controlli per la creazione di pagine di SharePoint, ad esempio pagine dell'applicazione. Questi controlli vengono visualizzati nella casella degli strumenti in Controlli SharePoint. La funzionalità di questi controlli deriva dallo spazio dei nomi Microsoft.SharePoint.WebControls , che contiene ASP.NET controlli server utilizzati nelle pagine del sito e dell'elenco di SharePoint.

Nome del controllo Descrizione
Aspmenu Inserisce un menu ASP. Per altre informazioni, vedere Cenni preliminari sul controllo menu.
CssLink Inserisce un elemento LINK nella pagina aspx e applica uno o più fogli di stile esterni definiti 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 la registrazione di risorse, ad esempio script, in una pagina in modo che possano essere richiesti quando viene eseguito il rendering della pagina.
Tema Applica un tema alla pagina aspx .

Eseguire il debug di una web part

È possibile eseguire il debug di un progetto di SharePoint che contiene una web part esattamente come si eseguirà il debug di altri progetti di Visual Studio. Quando si avvia il debugger di Visual Studio, Visual Studio apre il sito di SharePoint.

Per iniziare a eseguire il debug del codice, aggiungere la web part a una pagina web part in SharePoint.

Per altre informazioni su come eseguire il debug di progetti SharePoint, vedere Risolvere i problemi relativi alle soluzioni SharePoint.

Limitazioni delle web part visive

A partire da Visual Studio, è possibile aggiungere web part visive alle soluzioni SharePoint in modalità sandbox e alle soluzioni farm. Tuttavia, le web part visive presentano le limitazioni seguenti:

  • Le web part visive non supportano parametri sostituibili. Per altre informazioni, vedere Parametri sostituibili.

  • I controlli utente o le web part visive non possono essere trascinati e rimossi o copiati nelle web part visive. Questa azione causa un errore di compilazione.

  • Le web part visive non supportano direttamente i token del server SharePoint, ad esempio $SPUrl. Per altre informazioni, vedere "Restrizioni dei token in Visual Web part in modalità sandbox" nell'argomento Risolvere i problemi delle soluzioni SharePoint.

  • Le web part visive in una soluzione in modalità sandbox ricevono occasionalmente l'errore "La richiesta di esecuzione del codice in modalità sandbox è stata rifiutata perché il servizio host del codice in modalità sandbox era troppo occupato per gestire la richiesta". Per altre informazioni su questo errore, vedere questo post nel blog del team per sviluppatori di SharePoint.

  • Il debug JavaScript sul lato server non è supportato in Visual Studio, ma il debug JavaScript sul lato client è 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 di JavaScript, fare riferimento a un file JavaScript esterno nel file di markup e quindi impostare i punti di interruzione nel file JavaScript.

  • 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'uso della <@ Assembly Src= direttiva .

  • I controlli Web di SharePoint e alcuni controlli ASP.NET non sono supportati nell'ambiente in modalità sandbox di SharePoint. Se i controlli non supportati vengono utilizzati in una web part visiva in una soluzione in modalità sandbox, viene visualizzato l'errore "Il tipo o il nome dello spazio dei nomi 'Theme' non esiste nello spazio dei nomi 'Microsoft.SharePoint.WebControls'".

    Per altre informazioni sulle soluzioni in modalità sandbox, vedere Differenze tra soluzioni sandbox e farm.

Creare web part basate su SharePoint in stile precedente

È possibile usare i modelli in Visual Studio per creare web part personalizzate ASP.NET 2.0 per SharePoint. ASP.NET web part 2.0 si basano sull'infrastruttura della web part ASP.NET e sono il tipo consigliato per i nuovi progetti.

In pochissimi casi, potrebbe essere necessario creare una web part usando la web part basata su SharePoint in stile precedente. È possibile usare Visual Studio per creare questi tipi di web part, ma Visual Studio non fornisce modelli progettati appositamente per consentirti di crearli.

Per altre informazioni su quando si potrebbe voler creare una web part basata su SharePoint in stile precedente, vedere Infrastruttura web part in Windows SharePoint Services. Per altre informazioni su come creare una web part utilizzando la web part basata su SharePoint in stile precedente, vedere Procedura dettagliata Creazione di una web part di SharePoint di base.

Posizione Descrizione
Procedura: Creare una web part di SharePoint Viene illustrato come creare web part per le pagine di SharePoint.
Procedura: Creare una web part di SharePoint tramite una finestra di progettazione Viene illustrato come creare web part per SharePoint usando un'area di progettazione visiva.
Procedura: Creare un controllo utente per una pagina o una web part dell'applicazione SharePoint Illustra come creare controlli personalizzati riutilizzabili che possono essere utilizzati dalle pagine dell'applicazione e dalle web part eseguite in SharePoint.
Procedura dettagliata: Creare una web part per SharePoint Viene descritto come progettare una web part per SharePoint.
Procedura dettagliata: Creare una web part per SharePoint usando una finestra di progettazione Viene descritto come progettare una web part per SharePoint trascinando i controlli in un'area di progettazione visiva.
Procedura dettagliata: Creare web part Silverlight che visualizza OData per SharePoint Viene descritto come progettare una web part per SharePoint che ospita un'applicazione Silverlight e visualizzare i dati dagli elenchi di SharePoint.