Como: Incluir um controle de usuário em uma página da Web do ASP.NET

  • Artigo

Para usar um controle de usuário, você o inclui em um página Web do ASP.NET.Quando chega uma solicitação para uma página e essa página contémum controle de usuário, o controle de usuário passa por todos os estágios de processamento que qualquer controle de servidor ASP.NET executa.Para obter mais informações sobre esses estágios de processamento, consulte Visão Geral do Ciclo de Vida da Página ASP.NET.

Para incluir um controle de usuário em um página de Web Forms

  1. No conteúdo da página da Web do ASP.NET, crie uma diretiva @ Register que inclui:

    • Um atributo TagPrefix, que associa um prefixo ao controle de usuário.Esse prefixo será incluído na marca da abertura do elemento de controle de usuário.

    • Um atributo TagName, que associa um nome com o controle de usuário.Esse nome será incluído na marca de abertura do elemento de controle de usuário.

    • Um atributo Src, que define o caminho virtual para o arquivo de controle de usuário que você está incluindo.

      Observação:

      O Src valor de atributo pode ser um caminho absoluto ou relativo para o arquivo de fonte do controle de usuário do diretório de raiz do seu aplicativo. Para flexibilidade, é recomendável a você usar um caminho relativo.O caractere til (~) representa o diretório raiz do aplicativo.Os controles do usuário não podem ser localizados no Diretório App_Code.

  2. No corpo da página da Web, declare o elemento de controle de usuário dentro do elemento form.

  3. Opcionalmente, se o controle de usuário expõe propriedades públicas, defina as propriedades declarativamente.

Exemplo

O exemplo a seguir mostra um página da Web do ASP.NET que contém um controle de usuário.O controle de usuário está no arquivo Spinner.ascx na pasta de controles.Na página, o controle está registrado para usar o prefixo uc e o nome de marca Spinner.As propriedades MinValue e MaxValue do controle de usuário são definidas declarativamente.

Observação:

Para obter detalhes sobre o código para o controle de usuário usado neste exemplo, consulte Como: Criar controles de usuário do ASP.NET.

 
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner" 
    Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
    <uc:Spinner id="Spinner1" 
         
        MinValue="1" 
        MaxValue="10" />
</form>
</body>

Consulte também

Conceitos

Visão geral sobre controles de usuário ASP.NET

Criar Roteiro de Controles ASP.NET Personalizados