Compartir a través de


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

En Visual Studio, puede crear una personalizada, controles reutilizables que pueden usar las páginas de la 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 ASP.NET User Controls.

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 abrir el archivo de control de usuario en el proyecto y elija la ficha Diseño .Para obtener más información sobre cómo usar este diseñador, vea Visual Studio 11 Beta para el mapa de contenido web.

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 How to: Include a User Control in an ASP.NET Web Page.

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.