方法 : Visual Studio 2008 で ASP.NET AJAX 1.0 Web プロジェクトを操作する

2014-10-22

更新 : 2007 年 11 月

Visual Studio 2008 のマルチターゲットサポートを使用すると、新規および既存の Web サイトと Web アプリケーションプロジェクトの ASP.NET AJAX 1.0 を操作できます。既存のサイトを、ASP.NET および .NET Framework の最新バージョンにアップグレードせずに実行できます。同時に、Visual Studio 2008 で ASP.NET AJAX 1.0 Web サイトを開発および保守したり、JScript IntelliSense などの Visual Studio 2008 の新機能を使用したりできます。

以前のバージョンの ASP.NET と .NET Framework を使用して Web サイトを実行する方法は、最新のランタイムによるサイトの実行が現実的でない場合に役立ちます。この方法が有効な例として、次のような状況が考えられます。

Web サイトをホストしているホストサイトが、最新バージョンのランタイムにアップグレードされていない。
Web サイトが、現在のランタイムと互換性のないコントロールまたはコンポーネントと依存関係にある。

Visual Studio 2008 での新しい AJAX 1.0 Web サイトの作成

次の手順では、Visual Studio 2008 を使用して、新しい ASP.NET AJAX 1.0 Web サイトまたは Web アプリケーションプロジェクトを作成する方法について説明します。この手順は、完全版の Visual Studio 2008 と Visual Web Developer Express Edition で少し異なります。

新しい AJAX 1.0 Web サイトを作成するには

ASP.NET AJAX 1.0 をダウンロードしてインストールします。インストールプログラムは、ASP.NET AJAX の Web サイトからダウンロードできます。
新しい Web サイトを作成するには、次の操作を行います。
1. [ファイル] メニューの [新しい Web サイト] をクリックします。
2. [新しい Web サイト] ダイアログボックスで、[Visual Studio にインストールされたテンプレート] の下の [ASP.NET Web サイト] を選択します。
新しい Web アプリケーションプロジェクトを作成するには、次の操作を行います。
1. [ファイル] メニューの [新しいプロジェクト] をクリックします。
2. [新しいプロジェクト] ダイアログボックスで、[Visual Studio にインストールされたテンプレート] の下の [ASP.NET Web アプリケーション] を選択します。
Visual Web Developer Express Edition ではなく完全版の Visual Studio 2008 を使用している場合は、ターゲットフレームワークの一覧 (右上隅) の [.NET Framework 2.0] を選択します。
[OK] をクリックします。

新しい Web サイトまたは Web プロジェクトが作成されます。
Visual Web Developer Express Edition を使用している場合は、次の操作を行って、ターゲットフレームワークを 2.0 に変更します。
1. ソリューションエクスプローラでサイトの名前を右クリックし、[プロパティページ] をクリックします。
2. 左側の一覧の [ビルド] をクリックします。
3. [対象とする Framework] ボックスの一覧で、[.NET Framework 2.0] を選択します。
Web サイトフォルダのルートに、ASP.NET AJAX 1.0 Web.config ファイルを作成します。

ASP.NET AJAX 1.0 Web.config ファイルの内容の一覧については、後で説明する「ASP.NET AJAX 1.0 Web.config ファイルの内容」を参照してください。

Visual Studio 2008 で既存の ASP.NET AJAX 1.0 Web サイトを開く

既存の Web サイトまたは Web アプリケーションを最新バージョンのランタイムにアップグレードせずに、Visual Studio 2008 で操作できます。

既存の AJAX 1.0 Web サイトまたは Web アプリケーションプロジェクトを開くには

Web サイトまたは Web アプリケーションプロジェクトのバックアップコピーを作成します。

Web サイトまたはプロジェクトが誤ってアップグレードされると、サイトのファイルが影響を受け、元に戻すことはできません。
Visual Studio 2008 で Web サイトまたは Web アプリケーションプロジェクトを開きます。
Visual Studio 2008 によって、プロジェクトをアップグレードすることを確認するメッセージが表示されたら、[いいえ] をクリックします。

プロジェクトは、引き続き .NET Framework 2.0 が対象になります。

ASP.NET AJAX Control Toolkit アセンブリの更新

アプリケーションに ASP.NET AJAX Control Toolkit のコントロールまたはエクステンダが含まれている場合、Visual Studio 2008 で実行するためには、新しいバージョンの Control Toolkit にアップグレードする必要があります。最新バージョンの ASP.NET AJAX 1.0 Control Toolkit は、Codeplex の Web サイトからダウンロードできます。Version 1.0 (元のバージョン) のライブラリがあることを確認してください。

重要 :
この Control Toolkit は、コミュニティでサポートされているライブラリであり、Microsoft はサポートしていません。

Control Toolkit をインストールした後、Control Toolkit のコントロールをツールボックスに追加できます。

ASP.NET AJAX Control Toolkit のコントロールをツールボックスに追加するには

ASP.NET AJAX 1.0 Web サイトまたはプロジェクトで、ASP.NET Web ページ (Web フォーム) を開きます。
ツールボックスを右クリックし、[タブの追加] をクリックします。
新しいタブに "ASP.NET AJAX Toolkit 1.0" のような名前を付けます。
新しいタブを右クリックし、[アイテムの選択] をクリックします。

メモ :

このダイアログボックスを初めて開いたときは、ダイアログボックスが表示されるまで少し時間がかかることがあります。
[ツールボックスアイテムの選択] ダイアログボックスで、[参照] をクリックします。
AJAX Control Toolkit アセンブリが格納されているフォルダを参照し、AjaxControlToolkit.dll を選択して、[開く] をクリックします。

[ツールボックスアイテムの選択] ダイアログボックスで、Control Toolkit のコントロールが選択されます。
[OK] をクリックします。

ツールボックスにコントロールが追加されます。

メモ :
このダイアログボックスを初めて開いたときは、ダイアログボックスが表示されるまで少し時間がかかることがあります。

Visual Studio 2008 で AJAX 1.0 Web アプリケーションを操作できるようになりました。.NET Framework 2.0 を使用してアプリケーションをビルドおよび実行します。

次回から Visual Studio で Web サイトを開くときに、アップグレードするように求めるメッセージは表示されなくなります。ただし、.NET Framework の対象バージョンはいつでも .NET Framework version 3.5 に変更できます。詳細については、「方法 : ASP.NET AJAX 1.0 Web プロジェクトを .NET Framework 3.5 にアップグレードする」を参照してください。

AJAX 1.0 アプリケーションでの Visual Studio 2008 機能の使用

Visual Studio 2008 の新機能を使用すると AJAX 1.0 アプリケーションを開発できますが、次のような例外があります。

AJAX Web フォームや AJAX マスタページなどの AJAX 項目テンプレートは、[新しい項目の追加] ダイアログボックスでは使用できません。AJAX でサポートされる ASP.NET Web ページまたはマスタページを作成するには、通常のページを Web サイトに追加します。次に、ツールボックスからページに ScriptManager コントロールを追加します。
ASP.NET プロファイルサービスを操作するときに JScript IntelliSense は使用できません。
AJAX 1.0 Control Toolkit のエクステンダコントロールおよびサードパーティの ASP.NET AJAX 1.0 コントロールライブラリは、Visual Studio 2008 エクステンダのデザイン時拡張をサポートしません。たとえば、デザイン ビューで [エクステンダの選択...] スマートタグコマンドはサポートされません。

ASP.NET AJAX 1.0 Web.config ファイルの内容

ASP.NET AJAX 1.0 構成ファイルを作成するには、Web.config という名前のファイルを作成し、次の 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>

参照

概念

.Web サイトが対象とする .NET Framework の指定

ASP.NET Web サイトの移行と変換

概要 : Visual Studio の Web サイトおよびプロジェクトの Visual Studio 2008 の Web サイトおよびプロジェクトへの変換