Condividi tramite


Procedura: gestire un progetto Web di ASP.NET AJAX 1.0 in Visual Studio 2008

Aggiornamento: novembre 2007

Il supporto per più destinazioni in Visual Studio 2008 consente di utilizzare ASP.NET AJAX 1.0 in siti Web e progetti di applicazione nuovi ed esistenti. È possibile eseguire i siti esistenti senza aggiornarli alla versione più recente di ASP.NET e di .NET Framework. Al contempo è possibile sviluppare e gestire un sito Web ASP.NET AJAX 1.0 in Visual Studio 2008 e sfruttare le nuove funzionalità di Visual Studio 2008, ad esempio JScript IntelliSense.

L'esecuzione di un sito Web con una versione precedente di ASP.NET e di .NET Framework è utile quando non è pratico eseguire il sito con il runtime più recente. Di seguito vengono riportati alcuni esempi di quando ciò è utile:

  • Il sito che ospita il sito Web non è stato aggiornato alla versione più recente del runtime.

  • Il sito Web ha dipendenze da controlli o componenti non compatibili con il runtime corrente.

Creazione di un nuovo sito Web AJAX 1.0 in Visual Studio 2008

Le procedure descritte di seguito mostrano come creare un nuovo sito Web o un nuovo progetto applicazione Web ASP.NET AJAX 1.0 utilizzando Visual Studio 2008. La procedura differisce leggermente tra la versione completa di Visual Studio 2008 e Visual Web Developer Express Edition.

Per creare un nuovo sito Web AJAX 1.0

  1. Scaricare e installare ASP.NET AJAX 1.0. Il programma di installazione può essere scaricato da ASP.NET AJAX Web site (informazioni in lingua inglese).

  2. Per creare un nuovo sito Web, effettuare le seguenti operazioni:

    1. Scegliere Nuovo sito Web dal menu File.

    2. Nella finestra di dialogo Nuovo sito Web, selezionare Sito Web ASP.NET in Modelli Visual Studio installati.

  3. Per creare un nuovo progetto applicazione Web, effettuare le operazioni seguenti:

    1. Scegliere Nuovo progetto dal menu File.

    2. Nella finestra di dialogo Nuovo progetto, selezionare Applicazione Web ASP.NET in Modelli Visual Studio installati.

  4. Se si sta utilizzando la versione completa di Visual Studio 2008 (non Visual Web Developer Express Edition) nell'elenco dei framework di destinazione (nell'angolo superiore destro) selezionare .NET Framework 2.0.

  5. Scegliere OK.

    Viene creato il nuovo sito Web o progetto.

  6. Se si sta utilizzando Visual Web Developer Express Edition, impostare il framework di destinazione su 2.0 nel modo seguente:

    1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del sito e scegliere Pagine delle proprietà.

    2. Nell'elenco sinistro fare clic su Compila.

    3. Nell'elenco Framework di destinazione selezionare .NET Framework 2.0.

  7. Nella radice della cartella del sito Web creare un file Web.config ASP.NET AJAX 1.0.

    Per un elenco del contenuto di un file Web.config ASP.NET AJAX 1.0, vedere Contenuto del file Web.config ASP.NET AJAX 1.0 più avanti in questo argomento.

Apertura di un sito Web ASP.NET AJAX 1.0 esistente in Visual Studio 2008

È possibile utilizzare un sito Web o un'applicazione Web esistente in Visual Studio 2008 senza eseguire l'aggiornamento alla versione più recente del runtime.

Per aprire un sito Web o un progetto applicazione Web AJAX 1.0 esistente

  1. Fare una copia di backup del sito Web o del progetto applicazione Web.

    Se il sito Web o il progetto viene aggiornato senza volere, l'aggiornamento influisce sui file del sito e non può essere annullato.

  2. Aprire il progetto di sito Web o di applicazione Web in Visual Studio 2008.

  3. Quando Visual Studio 2008 chiede di aggiornare il progetto, fare clic su No.

    Il progetto continua a fare riferimento a .NET Framework 2.0.

Aggiornamento dell'assembly ASP.NET AJAX Control Toolkit

Se l'applicazione include controlli o estensioni di ASP.NET AJAX Control Toolkit, è necessario eseguire l'aggiornamento a una nuova versione di Control Toolkit affinché possa essere eseguita con Visual Studio 2008. È possibile scaricare la versione corrente di ASP.NET AJAX 1.0 Control Toolkit dal sito Web Codeplex (informazioni in lingua inglese). Verificare di ottenere la versione 1.0 (versione originale) della libreria.

Nota importante:

Control Toolkit è una libreria supportata dalle community e non è supportata da Microsoft.

Dopo l'installazione di Control Toolkit, è possibile installarne i controlli nella Casella degli strumenti.

Per aggiungere i controlli ASP.NET AJAX Control Toolkit nella Casella degli strumenti

  1. Nel sito Web o nel progetto ASP.NET AJAX 1.0 aprire una pagina Web ASP.NET (Web Form).

  2. Fare clic con il pulsante destro del mouse sulla Casella degli strumenti quindi scegliere Aggiungi scheda.

  3. Assegnare un nome alla nuova scheda, ad esempio "ASP.NET AJAX Toolkit 1.0".

  4. Fare clic con il pulsante destro del mouse sulla nuova scheda e scegliere Scegli elementi.

    Nota:

    Potrebbe verificarsi un ritardo prima che questa finestra di dialogo si apra per la prima volta.

  5. Nella finestra di dialogo Scegli elementi della Casella degli strumenti fare clic su Sfoglia.

  6. Passare alla cartella che contiene l'assembly AJAX Control Toolkit, selezionare AjaxControlToolkit.dll e quindi fare clic su Apri.

    I controlli di Control Toolkit vengono selezionati nella finestra di dialogo Scegli elementi della Casella degli strumenti.

  7. Scegliere OK.

    I controlli vengono aggiunti alla Casella degli strumenti.

È ora possibile utilizzare l'applicazione Web AJAX 1.0 in Visual Studio 2008. L'applicazione verrà compilata ed eseguita con .NET Framework 2.0.

Alla successiva apertura del sito Web in Visual Studio verrà nuovamente chiesto di eseguirne l'aggiornamento. Tuttavia, è possibile impostare la versione di destinazione di .NET Framework su .NET Framework versione 3.5 in qualsiasi momento. Per ulteriori informazioni, vedere Procedura: aggiornare un progetto Web di ASP.NET AJAX 1.0 a .NET Framework 3.5.

Utilizzo delle funzionalità di Visual Studio 2008 nelle applicazioni AJAX 1.0

È possibile utilizzare le nuove funzionalità di Visual Studio 2008 per sviluppare l'applicazione AJAX 1.0, con le eccezioni seguenti:

  • I modelli di elemento AJAX, ad esempio Web Form AJAX e Pagina master AJAX, non sono disponibili nella finestra di dialogo Aggiungi nuovo elemento. Per creare pagine Web ASP.NET o pagine master con supporto AJAX, aggiungere una pagina comune al sito Web. Quindi, dalla Casella degli strumenti aggiungere un controllo ScriptManager alla pagina.

  • JScript IntelliSense non è disponibile quando si utilizza il servizio profili ASP.NET.

  • I controlli Extender di AJAX 1.0 Control Toolkit o delle altre librerie di controlli di terze parti ASP.NET AJAX 1.0 non supporteranno i miglioramenti di Visual Studio 2008 della fase di progettazione. Ad esempio, non supporteranno il comando smart tag Choose Extender nella visualizzazione Progettazione.

Contenuto del file Web.config ASP.NET AJAX 1.0

Per creare un file di configurazione ASP.NET AJAX 1.0, creare un file denominato Web.config e quindi incollarvi il seguente codice XML:

<?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>

Vedere anche

Concetti

.Scelta della versione di NET Framework per i siti Web

Migrazione e conversione di siti Web ASP.NET

Cenni preliminari sulla conversione di progetti e siti Web di Visual Studio in Visual Studio 2008