Criando controles reutilizáveis para Web Parts ou páginas de aplicativo

Artigo
03/12/2013

Em o Visual Studio, você pode criar o personalizado, os controles reutilizáveis que podem ser consumidos por páginas e o Web Parts de aplicativo que executam no SharePoint.Esses controles são chamados controles de usuário.Para obter mais informações sobre controles de usuário, consulte ASP.NET User Controls.

Criando um controle de usuário

Para criar um controle de usuário, adicione Controle do Usuário a Projeto vazio do SharePoint.Para obter mais informações, consulte Como: criar um controle de usuário para uma página de aplicativo do SharePoint ou a Web Part.

Quando você adiciona um item de Controle do Usuário , o Visual Studio cria uma pasta em seu projeto, e então adiciona vários arquivos na pasta.A tabela a seguir descreve cada arquivo.

Arquivo	Descrição
Arquivo de controle de usuário	Define o controle de usuário.Criar o controle de usuário adicionando controles e marcação para o arquivo.
A codificação do arquivo	Contém o código de controle de usuário.Adicione código para tratar eventos para o arquivo.
Arquivo de código do designer	Contém o código gerado pelo designer e não deve ser editados diretamente.

Criando o controle de usuário

Criar o controle de usuário usando o designer do Visual Web Developer no Visual Studio.Este criador aparece quando você abre o arquivo de controle de usuário em seu projeto e clique na guia de Design .Para obter mais informações sobre como usar este designer, consulte Visual Studio Beta de 11 para o mapa de conteúdo da Web.

Consumindo o controle de usuário

Controles de usuário não aparecem no SharePoint até que você inclua o em uma página de aplicativo ou em um Web parts.

Para incluir um controle de usuário em uma página de aplicativo adicione uma diretiva de @ Register para a página do aplicativo, e então declare o controle de usuário para dentro de um ou mais espaços reservados de conteúdo na página.Para um exemplo de como realizar essa tarefa em uma página da Web padrão do ASP.NET, consulte How to: Include a User Control in an ASP.NET Web Page.

Para incluir um controle de usuário na Web parts, adicione o controle de usuário à coleção de Web parts Controls no arquivo de código de Web parts.O exemplo a seguir adiciona um controle de usuário à coleção de Controls de Web parts.

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

}

Depurando um controle de usuário

Para depurar um controle de usuário, certifique-se de que o controle de usuário está incluído em uma página ou a Web parts de aplicativo no projeto do SharePoint.Você pode então depurar o código no controle de usuário exatamente como você faria para depurar o código em qualquer projeto do Visual Studio.

Quando você inicia o depurador do Visual Studio, Visual Studio abrir o site do SharePoint.

Em o SharePoint, abra a página de aplicativo que inclui o controle de usuário.Se o controle de usuário é incluído na Web parts, adicione Web parts a uma página de Web parts no SharePoint.

Para obter mais informações sobre depuração de projetos do SharePoint, consulte Solucionando problemas de soluções do SharePoint.

Tópicos relacionados

Nome	Descrição
Como: criar um controle de usuário para uma página de aplicativo do SharePoint ou a Web Part	Mostra como criar um personalizado, os controles reutilizáveis que podem ser consumidos por páginas e o Web Parts de aplicativo que executam no SharePoint.
Trabalhando com o Visual Web Developer	Descreve como usar o designer que aparece quando você abrir uma página da Web em seu projeto.

Compartilhar via