Construindo os Exemplos de Controle de Servidor Personalizado

Artigo
10/15/2014

Este tópico descreve como compilar os exemplos de controles personalizados em um assembly e usar os controles em páginas da Web ASP.NET.Ela também descreve como você pode usar a pasta App_Code de um site ASP.NET da Web para testar o código de controle sem compilá-los.

Criar um conjunto de controle

Para criar e compilar os controles personalizados em um assembly.

Crie uma pasta para os arquivos de origem para controles personalizados e classes relacionadas.
Crie um arquivo de texto com a extensão de idioma apropriado para cada exemplo que você deseja compilar.

Por exemplo, crie um arquivo denominado MailLink.cs para o código do MailLink controle na Exemplo de Processamento de Controle Web C#.
Copie e cole o código-fonte para cada exemplo para o arquivo de texto correspondente e salve o arquivo.

Execute o seguinte comando a partir da pasta código-fonte para compilar os controles e classes relacionados em um assembly.

csc /t:library /out:Samples.AspNet.CS.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.cs

vbc /t:library /out:Samples.AspNet.VB.Controls.dll /r:System.dll 
/r:System.Web.dll /r:System.Design.dll *.vb

O opção do compilador /t:library impele o compilador a criar uma biblioteca (ao invés de executar um assembly).A opção /outfornece um nome para o conjunto de módulos e a opção /r lista os módulos que estão vinculados ao seu conjunto de módulos.

Observação:
If you cannot execute the compiler command, you must add the .NET Framework installation path to the Windows PATH variable before running the command.No Windows, clique com o botão direito do mouse My Computer, clique em Properties, clique na guia Advanced e, em seguida, clique no botão Environment Variables.Na lista Variáveis do sistema, clique duas vezes na variável Path.Na caixa de texto Variable value, adicione um ponto-e-vírgula (;) até o final dos valores existentes na caixa de texto e digite o caminho da instalação do .NET Framework.The .NET Framework is usually installed in the Windows installation folder at \Microsoft.NET\Framework\versionNumber.

If you cannot execute the compiler command, you must add the .NET Framework installation path to the Windows PATH variable before running the command.No Windows, clique com o botão direito do mouse My Computer, clique em Properties, clique na guia Advanced e, em seguida, clique no botão Environment Variables.Na lista Variáveis do sistema, clique duas vezes na variável Path.Na caixa de texto Variable value, adicione um ponto-e-vírgula (;) até o final dos valores existentes na caixa de texto e digite o caminho da instalação do .NET Framework.The .NET Framework is usually installed in the Windows installation folder at \Microsoft.NET\Framework\versionNumber.

Execute novamente o comando de compilação na etapa 4 sempre que você adicionar novos arquivos de origem para a pasta de código-fonte ou alterar os já existentes.

Criando um site da Web ASP.NET

Para criar o site da Web ASP.NET

Criar um site da Web ASP.NET usando Serviços de Informações da Internet (IIS) ou outra ferramenta.
Para obter informações sobre como criar e configurar um diretório virtual no IIS, consulte Como: Criar e configurar diretórios virtual no IIS 5.0 e 6.0.

Observação:

Se você quiser usar o IIS, instale o IIS antes de instalar o .NET Framework.
Crie uma pasta bin sob a pasta raiz de seu Web site.
Copie o assembly é criado no procedimento anterior para pasta Bin do site da Web.

Observação:

Se você recompile o assembly de controle (a etapa final na seção anterior) você deve recopie o novo conjunto para a pasta Bin do seu site da Web.

Observação:
Se você quiser usar o IIS, instale o IIS antes de instalar o .NET Framework.

Observação:
Se você recompile o assembly de controle (a etapa final na seção anterior) você deve recopie o novo conjunto para a pasta Bin do seu site da Web.

Criar um arquivo detexto chamado Web.config na pasta raiz de seu site Web, adicione o XML a seguir ao arquivo Web.config e, em seguida, salve o arquivo.

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.CS.Controls" 
          assembly="Samples.AspNet.CS.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true"/>
    <pages>
      <controls>
        <add tagPrefix="aspSample" 
          namespace="Samples.AspNet.VB.Controls" 
          assembly="Samples.AspNet.VB.Controls" >
        </add>
      </controls>
    </pages>
  </system.web>
</configuration>

Adicione um arquivo de texto com uma extensão .ASPX ao pasta raiz do seu Web site para cada exemplo que você deseja testar.

Por exemplo, crie um arquivo denominado MailLinkTest.aspx para a página de teste do controle MailLink fornecida em Exemplo de Processamento de Controle Web.
Copie e cole o código-fonte para cada página de teste exemplo para o arquivo .aspx correspondente e salve o arquivo.
Solicite as páginas .aspx um navegador da Web.

Por exemplo, se o seu site da Web é chamado ServerControls e ele inclui uma página chamada MailLinkTest.aspx, digite a seguinte URL na barra de endereço do seu navegador:
```
https://localhost/ServerControls/MailLinkTest.aspx
```

Usando a pasta App_Code para teste de controles

Você pode usar o recurso de compilação dinâmicos do ASP.NET 2.0 para testar controles sem precisar compilá-los em um assembly.

Para colocar os controles na pasta App_Code

Crie uma pasta App_Code sob a pasta raiz de seu Web Site.
Copie os arquivos de origem para os controles e classes relacionadas para a pasta App_Code.

Se você adicionou anteriormente um assembly para o controle à pasta Bin, exclua-o.

Observação:
Você pode pré-compilar um controle em um assembly e colocá-lo na pasta Bin ou colocar o arquivo de origem do controle na pasta App_Code.Se você adicionar o controle para ambas as pastas, o analisador de página não será capaz de resolver uma referência ao controle em uma página e irá gerar um erro.

Altere a entrada na seção controls o arquivo web.config para a seguinte entrada realçada, que mapeia namespace do controle para um prefixo de marca:

<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.CS.Controls">..</add>
</controls>

<controls>
  <add tagPrefix="aspSample"     namespace="Samples.AspNet.VB.Controls">..</add>
</controls>

Para obter mais informações, consulte @ Register.

Solicite as páginas .aspx um navegador da Web.

Se você colocar os arquivos de origem para as classes QuickContacts e ContactCollectionEditor de Exemplo da propriedade de coleção do controle da Web na pasta App_Code, você deve também adicionar uma referência para o conjunto de módulos System.Design na seção compilation do arquivo Web.config.Esta referência requer o nome totalmente qualificado do assembly System.Design.Você pode obter as informações necessárias para o nome totalmente qualificado, executando o Global ferramenta cache assembly (Gacutil.exe) que vem com o Windows Software Development Kit (SDK), usando a seguinte sintaxe:

gacutil /l System.Design

Observação:
Para executar o Global ferramenta cache assembly (Gacutil.exe) a partir de linha de comando, a variável de ambiente do Windows PATH de seu computador deve incluir o caminho para sua instalação do .NET Framework.No Windows, clique com o botão direito do mouse My Computer, clique em Properties, clique na guia Advanced e, em seguida, clique no botão Environment Variables.Na lista Variáveis do sistema, clique duas vezes na variável Path.Na caixa de texto Variable value, adicione um ponto-e-vírgula (;) até o final dos valores existentes na caixa de texto e digite o caminho da instalação do .NET Framework.The .NET Framework is usually installed in the Windows installation folder at \Microsoft.NET\Framework\versionNumber.

Para executar o Global ferramenta cache assembly (Gacutil.exe) a partir de linha de comando, a variável de ambiente do Windows PATH de seu computador deve incluir o caminho para sua instalação do .NET Framework.No Windows, clique com o botão direito do mouse My Computer, clique em Properties, clique na guia Advanced e, em seguida, clique no botão Environment Variables.Na lista Variáveis do sistema, clique duas vezes na variável Path.Na caixa de texto Variable value, adicione um ponto-e-vírgula (;) até o final dos valores existentes na caixa de texto e digite o caminho da instalação do .NET Framework.The .NET Framework is usually installed in the Windows installation folder at \Microsoft.NET\Framework\versionNumber.

A marca que você adiciona à seção compilation do arquivo Web.config é semelhante a da seção realçada no exemplo a seguir.No entanto, você deve substituir os valores da Version e os atributos PublicKeyToken com os valores retornados pela ferramenta Gacutil.exe.

<compilation >
  <assemblies>    <add assembly="System.Design, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />    </assemblies>
</compilation>

Observação:
Se você estiver usando um ambiente de desenvolvimento integrado, o designer pode fornecer uma técnica simples para adicionar uma referência de assembly para o arquivo Web.config.Por exemplo, no Visual Studio 2005, se você clicar com o botão direito do mouse em site do nome no gerenciador de soluções e clique em Adicionar referência no menu de atalho, você pode usar uma caixa de diálogo que permite que você selecionar um assembly para adicionar.Quando você seleciona o assembly, o designer adiciona automaticamente a entrada relevante para o arquivo Web.config.

Se você estiver usando um ambiente de desenvolvimento integrado, o designer pode fornecer uma técnica simples para adicionar uma referência de assembly para o arquivo Web.config.Por exemplo, no Visual Studio 2005, se você clicar com o botão direito do mouse em site do nome no gerenciador de soluções e clique em Adicionar referência no menu de atalho, você pode usar uma caixa de diálogo que permite que você selecionar um assembly para adicionar.Quando você seleciona o assembly, o designer adiciona automaticamente a entrada relevante para o arquivo Web.config.

Consulte também

Tarefas

Explicação Passo a Passo: Desenvolvendo e Usando um Controle de Servidor Personalizado

Outros recursos

Desenvolvendo Controles Personalizados ASP.NET Server

Compartilhar via