Creazione di controlli utente riutilizzabili per web part o pagine applicazione

Articolo
08/11/2011

In Visual Studio è possibile creare controlli riutilizzabili e personalizzati che possono essere utilizzati nelle pagine applicazione e nelle web part eseguite in SharePoint. Questi controlli sono denominati controlli utente. Per ulteriori informazioni sui controlli utente, vedere Controlli utente ASP.NET.

Creazione di un controllo utente

Per creare un controllo utente, aggiungere un Controllo utente a un Progetto SharePoint vuoto. Per ulteriori informazioni, vedere Procedura: creare un controllo utente per una web part o una pagina applicazione di SharePoint.

Quando si aggiunge un elemento Controllo utente, in Visual Studio viene creata una cartella nel progetto, quindi vengono aggiunti alcuni file alla cartella. Nella tabella riportata di seguito viene descritto ogni file.

File	Descrizione
File di controllo utente	Definisce il controllo utente. Per progettare il controllo utente, aggiungere controlli e markup a questo file.
File di codice	Contiene il file code-behind del controllo utente. Aggiungere codice a questo file per gestire gli eventi.
File di codice della finestra di progettazione	Contiene codice generato tramite la finestra di progettazione e non deve essere modificato direttamente.

Progettazione del controllo utente

Per progettare il controllo utente, utilizzare la finestra di progettazione di Visual Web Developer in Visual Studio. Questa finestra di progettazione viene visualizzata quando si fa doppio clic sul file di controllo utente nel progetto. Per ulteriori informazioni sull'utilizzo di questa finestra di progettazione, vedere Mappa del contenuto per Visual Web Developer.

Utilizzo del controllo utente

I controlli utente non sono visualizzati in SharePoint finché non vengono inclusi in una pagina applicazione o in una web part.

Per includere un controllo utente in una pagina applicazione, aggiungere un'istruzione @ Register alla pagina applicazione, quindi dichiarare il controllo utente all'interno di uno o più segnaposto contento nella pagina. Per un esempio su come portare a termine questa attività in una pagina Web ASP.NET standard, vedere Procedura: includere un controllo utente in una pagina Web ASP.NET.

Per includere un controllo utente in una web part, aggiungere il controllo utente all'insieme di web part Controls nel file di codice della web part. Nell'esempio riportato di seguito viene aggiunto un controllo utente all'insieme di web part Controls.

<ToolboxItemAttribute(false)> _
Public Class VisualWebPart1
    Inherits WebPart

    Private Const _ascxPath As String = "~/_CONTROLTEMPLATES/VB/VisualWebPart1/VisualWebPart1UserControl.ascx"

    Public Sub New()
    End Sub

    Protected Overrides Sub CreateChildControls()
        Dim control As Control = Page.LoadControl(_ascxPath)
        Controls.Add(control)
        MyBase.CreateChildControls()
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
        MyBase.RenderContents(writer)
    End Sub

End Class

[ToolboxItemAttribute(false)]
public class VisualWebPart1 : WebPart
{
    private const string _ascxPath = @"~/_CONTROLTEMPLATES/CS/VisualWebPart1/VisualWebPart1UserControl.ascx";

    public VisualWebPart1()
    {
    }

    protected override void CreateChildControls()
    {
        Control control = this.Page.LoadControl(_ascxPath);
        Controls.Add(control);
        base.CreateChildControls();
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
        base.RenderContents(writer);
    }

}

Debug di un controllo utente

Per eseguire il debug di un controllo utente, assicurarsi che sia incluso in una pagina applicazione o in una web part nel progetto SharePoint. Sarà quindi possibile eseguire il debug del codice nel controllo utente procedendo come per qualsiasi progetto di Visual Studio.

Quando si avvia il debugger di Visual Studio, viene aperto il sito di SharePoint.

In SharePoint aprire la pagina applicazione che include il controllo utente. Se tale controllo utente è incluso in una web part, aggiungere quest'ultima a una pagina web part in SharePoint.

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

Argomenti correlati

Titolo	Descrizione
Procedura: creare un controllo utente per una web part o una pagina applicazione di SharePoint	Viene illustrato come creare controlli riutilizzabili e personalizzati che possono essere utilizzati nelle pagine applicazione e nelle Web part eseguite in SharePoint.
Utilizzo di Visual Web Developer	Viene descritto come utilizzare la finestra di progettazione visualizzata quando si apre una pagina Web nel progetto.

Condividi tramite