Gewusst wie: Aktualisieren eines ASP.NET AJAX 1.0-Webprojekts auf .NET Framework 3.5

Aktualisiert: November 2007

Visual Studio 2008 enthält eine neue Version von ASP.NET-AJAX, die Verbesserungen gegenüber der ASP.NET-AJAX 1.0-Version bietet. In diesem Thema wird beschrieben, wie Sie vorhandene ASP.NET-AJAX 1.0-Websites und Webanwendungsprojekte aktualisieren, um die AJAX-Unterstützung in .NET Framework 3.5 und Visual Studio 2008 zu verwenden.

Aktualisieren auf die neue Version von ASP.NET-AJAX

So aktualisieren Sie ASP.NET-AJAX-Websites oder Webanwendungsprojekte

  1. Erstellen Sie eine Sicherungskopie des Projekts.

  2. Starten Sie Visual Studio 2008.

  3. Öffnen Sie das Projekt. Führen Sie eine der folgenden Aktionen aus:

    • Wenn Sie mit einer Website arbeiten, klicken Sie im Menü Datei auf Website öffnen und öffnen dann die Website oder das virtuelle IIS-Verzeichnis.

    • Wenn Sie mit einem Webanwendungsprojekt arbeiten, klicken Sie im Menü Datei auf Projekt öffnen, greifen auf die Projektdatei zu und öffnen diese.

    Der Visual Studio-Konvertierungs-Assistent wird geöffnet. Folgen Sie den Anweisungen des Assistenten, um das Projekt zu aktualisieren.

  4. Wenn Sie in Visual Studio 2008 aufgefordert werden, die Website zu aktualisieren, klicken Sie auf Ja.

Aktualisieren der ASP.NET-AJAX Control Toolkit-Assembly

Wenn Ihre Anwendung Steuerelemente oder Extender aus dem ASP.NET-AJAX Control Toolkit enthält, müssen Sie eine Aktualisierung auf eine neue Control Toolkit-Version durchführen, um es zusammen mit .NET Framework 3.5 ausführen zu können. Sie können die aktuelle ASP.NET-AJAX 1.0 Control Toolkit-Version von der Codeplex-Website (möglicherweise in englischer Sprache) herunterladen.

Wichtiger Hinweis:

Das Control Toolkit ist eine durch eine Community unterstützte Bibliothek, die von Microsoft nicht unterstützt wird.

So aktualisieren Sie die ASP.NET-AJAX Control Toolkit-Assembly

  1. Laden Sie die aktuelle ASP.NET-AJAX Control Toolkit-Version für .NET Framework 3.5 herunter. Das Control Toolkit ist auf der Codeplex-Website verfügbar.

  2. Klicken Sie in Windows-Explorer mit der rechten Maustaste auf die ZIP-Datei mit dem Control Toolkit, und klicken Sie dann auf Alle extrahieren….

  3. Extrahieren Sie den Inhalt in einem Ordner mit dem Namen AjaxControlToolkit-Framework3.5 in demselben Verzeichnis.

  4. Kopieren Sie die AjaxControlToolkit.dll-Assembly aus AjaxControlToolkit-Framework3.5\SampleWebSite\Bin in das Verzeichnis Bin Ihrer Anwendung, und ersetzen Sie die ältere Version der Control Toolkit-Assembly.

Optional können Sie die Steuerelemente des ASP.NET-AJAX Control Toolkit in der Visual Studio-Toolbox installieren.

So installieren Sie die Steuerelemente des ASP.NET-AJAX Control Toolkit in der Toolbox

  1. Öffnen Sie auf ASP.NET-AJAX 1.0-Website bzw. im -Projekt eine ASP.NET-Webseite (Web Form).

  2. Klicken Sie mit der rechten Maustaste auf die Toolbox, und klicken Sie anschließend auf Registerkarte hinzufügen.

  3. Geben Sie der neuen Registerkarte einen Namen, z. B. "ASP.NET-AJAX-Toolkit 1.0".

  4. Klicken Sie mit der rechten Maustaste auf die neue Registerkarte, und klicken Sie anschließend auf Elemente auswählen….

    Hinweis:

    Es kann ggf. eine Verzögerung geben, bevor dieses Dialogfeld zum ersten Mal geöffnet wird.

  5. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf Durchsuchen….

  6. Greifen Sie auf \AjaxControlToolkit-Framework3.5\SampleWebSite\Bin zu, wählen Sie AjaxControlToolkit.dll, und klicken Sie dann auf Öffnen.

    Die Steuerelemente aus dem Control Toolkit werden im Dialogfeld Toolboxelemente auswählen ausgewählt.

  7. Klicken Sie auf OK.

    Die Steuerelemente werden der Toolbox hinzugefügt.

Verwenden von AJAX 1.0-Komponenten in einem aktualisierten Projekt

Es ist eine neue Version des Microsoft ASP.NET-AJAX Control Toolkit verfügbar, die in .NET Framework 3.5 mithilfe der ASP.NET-AJAX-Assembly (System.Web.Extensions) kompiliert wird. Ihre Anwendung enthält jedoch ggf. Komponenten oder Assemblys von Drittanbietern, die mithilfe von ASP.NET-AJAX 1.0 kompiliert wurden. Wenn Sie eine Website auf .NET Framework 3.5 aktualisieren, wird der Web.config-Datei der ASP.NET-AJAX 3.5-Anwendung ein bindingRedirect-Abschnitt hinzugefügt. Dieser Abschnitt ermöglicht es vorkompilierten Komponenten von Drittanbietern, eine Bindung zur Version 3.5 der System.Web.Extensions-Assembly herzustellen, anstatt eine Bindung zur Version 1.0.

Hinweis:

Der Abschnitt bindingRedirect ist nur zur Laufzeit gültig. Zur Entwurfszeit verweist die Komponente eines Drittanbieters auf Version 1.0 der System.Web.Extensions-Assembly. Damit der Steuerelement-Designer funktioniert, müssen Sie AJAX 1.0 installieren. Sie sollten nach Möglichkeit eine Version der Komponente beschaffen, die für Version 3.5 der System.Web.Extensions-Assembly kompiliert ist.

Siehe auch

Aufgaben

Gewusst wie: Arbeiten mit einem ASP.NET AJAX 1.0-Webprojekt in Visual Studio 2008

Konzepte

.Verwenden von .NET Framework für Websites

Migrieren und Konvertieren von ASP.NET-Websites

Übersicht: Konvertieren von Visual Studio-Websites und -Projekten in Visual Studio 2008