Registrar um assembly em um WebForm para usar um controle personalizado

Este artigo fornece informações para disponibilizar e registrar um assembly em um WebForm para usar com ASP.NET controles de servidor personalizados.

Versão original do produto: ASP.NET
Número de KB original: 321749

Propriedades de assembly de exemplo

Para ser representado como um Controle de Servidor Personalizado, o assembly deve ter uma classe da qual deriva direta ou indiretamente System.Web.UI.Control e você deve incluir a classe em um namespace. Exemplos neste artigo pressupõem que a classe está fechada no CustomControlNamespace namespace e que o assembly foi compilado com êxito em um arquivo chamado CustomControl.dll.

Disponibilizar um assembly para ASP.NET aplicativo

Para disponibilizar um assembly para um aplicativo ASP.NET, você deve colocar o .dll do assembly na /bin pasta do aplicativo.

1. Navegue até o diretório raiz do aplicativo no Windows Explorer.

   Para descobrir qual é a pasta do projeto de aplicativo:

   1. No ambiente .NET, no menu Exibir, selecione Gerenciador de Soluções.
   2. Clique com o botão direito do mouse em um item de main do projeto no Gerenciador de Soluções e selecione Propriedades.
   3. Na caixa de diálogo Propriedades do Projeto , selecione Propriedades Comuns e selecione Geral.

   No painel de árvores, você verá a lista com a propriedade Pasta do Projeto . Normalmente, esse é o diretório raiz do aplicativo.

2. Em uma pasta de projeto do Aplicativo Web, crie uma pasta chamada bin se ela não existir.

3. Copie ou mova o .dll do assembly nesta pasta. Agora você pode usar o controle de qualquer página ASP.NET no diretório raiz do aplicativo (ou em qualquer uma de suas subpastas).

Registrar o assembly em um formulário Web de aplicativo ASP.NET

Em um ambiente de programação do .NET, abra o Form.aspx janela de origem e adicione a seguinte marca na parte superior do código:

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

No código acima:

• Custom é um alias que você associa a um namespace.
• CustomControlNamespace é um namespace no qual as classes de um assembly são fechadas.
• CustomControl é o nome do arquivo de assembly sem uma extensão (.dll).

Em seu código, altere esses parâmetros para os nomes apropriados para o assembly.

Agora o assembly está registrado em um Formulário Web. Você pode usar esse assembly registrado em seu código ASP.NET com os nomes escolhidos. Por exemplo, a marca pode ser:

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

Na marca acima, Custom é o nome escolhido para o namespace do assembly, CustomControl é o nome de controle do servidor personalizado e parameter 1parameter2 são propriedades de controle opcionais que variam de acordo com o código real.