Partilhar via


Como: Trabalhar com um ASP.NET AJAX 1.0 projeto Web no Visual Studio 2008

Suporte multiplataforma no Visual Studio 2008 permite que você trabalhe com AJAX 1.0 do ASP.NET em sites da Web novos e existentes e em projetos de aplicativos Web.Você pode executar sites existentes sem atualizá-los para a versão mais recente do ASP.NET e do .NET Framework.Ao mesmo tempo, você pode desenvolver e manter um site ASP.NET AJAX 1.0 no Visual Studio 2008 e se beneficiar dos novos recursos Visual Studio 2008, como o JScript IntelliSense.

Executar um site usando uma versão anterior do ASP.NET e do .NET Framework é útil quando não é prático para você executar o site usando o tempo de execução mais recente.Exemplos de quando isso é útil incluem o seguinte:

  • O site de hospedagem que hospeda o seu site não foi atualizado para a versão mais recente do tempo de execução.

  • O seu site tem dependências nos controles ou componentes que não são compatíveis com o tempo de execução atual.

Criando um novo site AJAX 1.0 no Visual Studio 2008

Os procedimentos a seguir mostram como criar um novo site da Web ASP.NET AJAX 1.0 ou um projeto de aplicativo Web, usando Visual Studio 2008.O procedimento difere ligeiramente entre a versão completa do Visual Studio 2008 e Visual Web Developer Express Edition.

Para criar um novo site AJAX 1.0

  1. Faça o download e instale o ASP.NET AJAX 1.0.Você pode baixar o programa de instalação do Site da Web do ASP.NET AJAX.

  2. Para criar um novo site, faça o seguinte:

    1. No menu Arquivo, clique em Novo Site da Web.

    2. Na caixa de diálogo New Web Site, em Visual Studio installed templates, selecione ASP.NET Web Site.

  3. Para criar um novo projeto de aplicativo Web, faça o seguinte:

    1. No menu File, clique em New Project.

    2. Na caixa de diálogo New Project, em Visual Studio installed templates, selecione ASP.NET Web Application.

  4. Se você estiver usando a versão completa do Visual Studio 2008 (não Visual Web Developer Express Edition) na lista de estrutura de destino (no canto superior direito), selecione .NET Framework 2.0.

  5. Clique em OK.

    O novo site ou projeto é criado.

  6. Se você estiver usando Visual Web Developer Express Edition, altere a estrutura de destino para 2.0, fazendo o seguinte:

    1. No Solution Explorer, clique com o botão direito do mouse no nome do site e clique em Property Pages.

    2. Na lista à esquerda, clique em Build.

    3. Na lista Target Framework lista, selecione .NET Framework 2.0.

  7. Na raiz da pasta do site, crie um arquivo Web.config ASP.NET AJAX 1.0.

    Para obter uma listagem do conteúdo de um arquivo Web.config ASP.NET AJAX 1.0, consulte Conteúdo do arquivo Web.config ASP.NET AJAX 1.0 posteriormente neste tópico.

Abrindo um site ASP.NET AJAX 1.0 existente no Visual Studio 2008

Você pode trabalhar com um site ou aplicativo da Web existente no Visual Studio 2008, sem atualizar para a versão mais recente do tempo de execução.

Para abrir um projeto de aplicativo Web ou site AJAX 1.0 existente

  1. Faça uma cópia de backup do site ou projeto do aplicativo Web.

    Se o site ou projeto, inadvertidamente, for atualizado, a atualização afeta os arquivos do site e não pode ser desfeita.

  2. Abra o projeto do aplicativo Web ou o site em Visual Studio 2008.

  3. Quando Visual Studio 2008 solicitar que você atualize o projeto, clique em Não 

    O Projeto continuará a ter como destino .NET Framework 2,0.

Atualizando o conjunto de módulos do Kit de Ferramentas de Controle ASP.NET AJAX

Se seu aplicativo incluir controles ou extenders do kit de Ferramentas de Controle AJAX ASP.NET, você deve atualizar para uma nova versão do Kit de Ferramentas de Controle para executar com Visual Studio 2008.Você pode baixar o versão corrente do ASP.NET AJAX 1.0 controle Toolkit do Site da CodePlex.Certifique-se que você obtém a versão 1.0 (a versão original) da biblioteca.

Observação importante:

O kit de Ferramentas de controle é uma biblioteca suportada pela comunidade e não é suportado pela Microsoft.

Depois de instalar o kit de Ferramentas de controle, você pode adicionar os controles do kit de ferramentas para a Caixa de Ferramentas.

Para adicionar os controles do kit de ferramentas ASP.NET AJAX para a Caixa de ferramentas

  1. No site ASP.NET AJAX 1.0 ou no projeto, abra uma página da Web ASP.NET (Web Form).

  2. Clique com o botão direito do mouse em ToolBox e, em seguida, clique em Add Tab.

  3. Dê um nome à nova guia, como "ASP.NET AJAX Toolkit 1.0".

  4. Clique com o botão direito do mouse na nova guia e, em seguida, clique em Escolher Items….

    Observação:

    Pode haver um atraso antes desta caixa de diálogo caixa é aberta pela primeira vez.

  5. Na caixa de diálogo Choose Toolbox Items, clique em Browse….

  6. Vá para a pasta que contém o conjunto do kit de ferramentas de controle AJAX, selecione AjaxControlToolkit.dll e em seguida, clique em Abrir.

    Os controles do kit de ferramentas são selecionados na caixa de diálogo Choose Toolbox Items.

  7. Clique em OK.

    Os controles são adicionados à Toolbox.

Você agora pode trabalhar com o aplicativo Web AJAX 1.0 no Visual Studio 2008.O aplicativo irá criar e executar usando o .NET Framework 2,0.

Na próxima vez que você abrir o site no Visual Studio, você não será solicitado novamente para atualizá-lo.No entanto, você pode alterar a versão de destino do .NET Framework como .NET Framework versão 3.5 a qualquer momento.Para obter mais informações, consulte Como: Atualizar um ASP.NET AJAX 1.0 projeto Web para o .NET estrutura 3.5.

Usando recursos do Visual Studio 2008 em aplicativos AJAX 1.0

Você pode usar os novos recursos em Visual Studio 2008 para desenvolver o aplicativo AJAX 1.0, com as seguintes exceções:

  • Os modelos de item AJAX, como AJAX Web Form e AJAX Master Page não estão disponíveis na caixa de diálogo Add New Item.Para criar páginas ASP.NET ou páginas mestras com suporte AJAX, adicione uma página comum para o site da Web.Depois, da Caixa de Ferramentas, adicione um controle ScriptManager à página.

  • JScript IntelliSense não está disponível quando você trabalha com o serviço de perfil do ASP.NET.

  • Controles extensores do kit de ferramentas de controle AJAX 1.0 ou outras bibliotecas de controle de terceiros AJAX ASP.NET 1.0 não oferecem suporte a aprimoramentos em tempo de design de extensor Visual Studio 2008.Por exemplo, eles não oferecerão suporte ao comando de marca inteligente Choose Extender... no modo Design.

Conteúdo do arquivo Web.config do ASP.NET AJAX 1.0

Para criar um arquivo de configuração ASP.NET AJAX 1.0, crie um arquivo chamado Web.config e então cole nele o XML a seguir:

<?xml version="1.0"?>
<configuration>
  <configSections>
    <sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
      <sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
        <section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="MachineToApplication"/>
        <sectionGroup name="webServices" type="System.Web.Configuration.ScriptingWebServicesSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
          <section name="jsonSerialization" type="System.Web.Configuration.ScriptingJsonSerializationSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="Everywhere"/>
          <section name="profileService" type="System.Web.Configuration.ScriptingProfileServiceSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="MachineToApplication"/>
          <section name="authenticationService" type="System.Web.Configuration.ScriptingAuthenticationServiceSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="MachineToApplication"/>
        </sectionGroup>
      </sectionGroup>
    </sectionGroup>
  </configSections>
  <system.web>
    <pages>
      <controls>
        <add tagPrefix="asp" namespace="System.Web.UI" assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </controls>
    </pages>
    <compilation debug="true">
      <assemblies>
        <add assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
        <add assembly="System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>
        <add assembly="System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
      </assemblies>
    </compilation>
    <httpHandlers>
      <remove verb="*" path="*.asmx"/>
      <add verb="*" path="*.asmx" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      <add verb="*" path="*_AppService.axd" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      <add verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" validate="false"/>
    </httpHandlers>
    <httpModules>
      <add name="ScriptModule" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
    </httpModules>
  </system.web>
  <system.web.extensions>
    <scripting>
      <webServices>
        <!-- Uncomment this line to customize maxJsonLength and add a custom converter -->
        <!--
          <jsonSerialization maxJsonLength="500">
            <converters>
              <add name="ConvertMe" type="Acme.SubAcme.ConvertMeTypeConverter"/>
            </converters>
          </jsonSerialization>
        -->
        <!-- Uncomment this line to enable the authentication service. Include requireSSL="true" if appropriate. -->
        <!--
          <authenticationService enabled="true" requireSSL = "true|false"/>
        -->
        <!-- Uncomment these lines to enable the profile service. To allow profile properties to be retrieved
             and modified in ASP.NET AJAX applications, you need to add each property name to the readAccessProperties and
             writeAccessProperties attributes. -->
        <!--
          <profileService enabled="true"
            readAccessProperties="propertyname1,propertyname2"
            writeAccessProperties="propertyname1,propertyname2" />
        -->
      </webServices>
      <!--
        <scriptResourceHandler enableCompression="true" enableCaching="true" />
      -->
    </scripting>
  </system.web.extensions>
  <system.webServer>
    <validation validateIntegratedModeConfiguration="false"/>
    <modules>
      <add name="ScriptModule" preCondition="integratedMode" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
    </modules>
    <handlers>
      <remove name="WebServiceHandlerFactory-Integrated"/>
      <add name="ScriptHandlerFactory" verb="*" path="*.asmx" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      <add name="ScriptHandlerFactoryAppServices" verb="*" path="*_AppService.axd" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      <add name="ScriptResource" preCondition="integratedMode" verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
    </handlers>
  </system.webServer>
</configuration>

Consulte também

Conceitos

Direcionamento do .NET Framework para sites da Web

Migrating and Converting ASP.NET Web Sites

Visão geral: Convertendo Sites e Projetos Web para o Visual Studio 2008