Creare controlli riutilizzabili per web part o pagine dell'applicazione

In Visual Studio è possibile creare controlli riutilizzabili personalizzati che possono essere utilizzati dalle pagine applicazione e dalle Web part eseguite in SharePoint. Questi controlli sono denominati controlli utente. Un controllo utente è un tipo di controllo composito che funziona in modo molto simile a una pagina Web ASP.NET. È possibile aggiungere controlli server Web e markup esistenti a un controllo utente e definire proprietà e metodi per il controllo. È quindi possibile incorporarli in ASP.NET pagine Web, dove fungono da unità.

Creare un controllo utente

Per creare un controllo utente, aggiungere un controllo utente a un progetto SharePoint vuoto. Per altre informazioni, vedere Procedura: Creare un controllo utente per una pagina o una web part dell'applicazione SharePoint.

Quando si aggiunge un elemento controllo utente, Visual Studio crea una cartella nel progetto e quindi aggiunge diversi file alla cartella. La tabella seguente descrive ogni file.

File	Descrizione
File di controllo utente	Definisce il controllo utente. Progettare il controllo utente aggiungendo controlli e markup a questo file.
File di codice	Contiene codice dietro il controllo utente. Aggiungere il codice per gestire gli eventi a questo file.
File di codice della finestra di progettazione	Contiene il codice generato dalla finestra di progettazione e non deve essere modificato direttamente.

Progettare il controllo utente

Progettare il controllo utente usando la finestra di progettazione Visual Web Developer in Visual Studio. Questa finestra di progettazione viene visualizzata quando si apre il file di controllo utente nel progetto e si sceglie la scheda Progettazione .

Utilizzare il controllo utente

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

Per includere un controllo utente in una pagina dell'applicazione, aprire la pagina Web a cui si desidera aggiungere il controllo utente ASP.NET. Passare alla visualizzazione Progettazione, quindi selezionare il file di controllo utente personalizzato in Esplora soluzioni e trascinarlo nella pagina. Il controllo utente ASP.NET viene aggiunto alla pagina e la finestra di progettazione crea la direttiva @ Register, necessaria per riconoscere il controllo utente nella pagina. È ora possibile usare le proprietà e i metodi pubblici del controllo.

Per includere un controllo utente in una web part, aggiungere il controllo utente alla raccolta web part nel file di codice della web part Controls . Nell'esempio seguente viene aggiunto un controllo utente alla Controls raccolta di una web part.

C#

[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);
    }
    
}

VB

<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

Eseguire il debug di un controllo utente

Per eseguire il debug di un controllo utente, assicurarsi che il controllo utente sia incluso in una pagina dell'applicazione o in una web part nel progetto di SharePoint. È quindi possibile eseguire il debug del codice nel controllo utente esattamente come si eseguirà il debug del codice in qualsiasi progetto di Visual Studio.

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

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

Per altre informazioni sul debug di progetti SharePoint, vedere Risolvere i problemi delle soluzioni SharePoint.

Argomenti correlati

Posizione	Descrizione
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 Web part che vengono eseguiti in SharePoint.