Crear controles reutilizables para elementos web o páginas de aplicación

Visual Studio permite crear controles de usuario personalizados y reutilizables que pueden usar las páginas de aplicación y los elementos web que se ejecutan en SharePoint. Estos controles se denominan controles de usuario. Para obtener más información acerca de los controles de usuario, vea Controles de usuario ASP.NET.

Crear un control de usuario

Para crear un control de usuario, agregue un Control de usuario a un Proyecto de SharePoint vacío. Para obtener más información, vea Cómo: Crear un control de usuario para una página de aplicación o elemento web de SharePoint.

Al agregar un elemento Control de usuario, Visual Studio crea una carpeta en su proyecto y le agrega varios archivos. En la tabla siguiente se describe cada archivo.

Archivo	Descripción
Archivo control de usuario	Define el control de usuario. Diseñe el control de usuario agregando controles y marcado a este archivo.
Archivo de código	Contiene código subyacente del control de usuario. Agregue código para controlar los eventos a este archivo.
Archivo de código del diseñador	Contiene código generado por el diseñador y no debe modificarse.

Diseñar el control de usuario

Diseñe el control de usuario utilizando el diseñador de Visual Web Developer en Visual Studio. Este diseñador aparece al hacer doble clic en el archivo de control de usuario de su proyecto. Para obtener más información sobre cómo usar este diseñador, vea Mapa de contenido de Visual Web Developer.

Utilizar el control de usuario

Los controles de usuario no aparecen en SharePoint hasta que no se incluyen en una página de aplicación o en un elemento web.

Para incluir un control de usuario en una página de aplicación, agregue una directiva @ Register a la página de aplicación y, a continuación, declare el control de usuario dentro de uno o más marcadores de posición de contenido en la página. Para obtener un ejemplo de cómo lograr esta tarea en una página web ASP.NET estándar, vea Cómo: Incluir un control de usuario en una página web ASP.NET.

Para incluir un control de usuario en un elemento web, agréguelo a la colección Controls del archivo de código del elemento web. En el ejemplo siguiente se muestra cómo agregar el control de usuario a la colección Controls de un elemento web.

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

}

Depurar un control de usuario

Para depurar un control de usuario, asegúrese de que está incluido en una página de aplicación o elemento web en el proyecto SharePoint. Puede depurar código en el control de usuario del mismo modo que depuraría código en un proyecto de Visual Studio.

Al iniciar el depurador de Visual Studio, Visual Studio abre el sitio de SharePoint.

En SharePoint, abra la página de aplicación que incluye el control de usuario. Si el control de usuario está incluido en un elemento web, agregue el elemento web a un página de elementos web en SharePoint.

Para obtener más información sobre la depuración de proyectos de SharePoint, vea Solucionar problemas de soluciones de SharePoint.

Temas relacionados

Título	Descripción
Cómo: Crear un control de usuario para una página de aplicación o elemento web de SharePoint	Muestra cómo se crean controles personalizados y reutilizables que se pueden usar en las páginas de aplicación y los elementos web que se ejecutan en SharePoint.
Trabajar con Visual Web Developer	Describe cómo utilizar el diseñador que aparece al abrir una página web en el proyecto.