AspNetAjaxLibrary0911版本 翻譯by hongwise.doc

ASP.NET Ajax Library Beta version 0911Release Notes(發(fā)步說明)概要1綜述2發(fā)布版本包含了什么2Visual Studio 兼容性3使用指南，參考文檔和示例代碼3兼容的瀏覽器4如何使用ASP.NET Ajax Library Scripts4添加ASP.NET Ajax Library到Visual Studio工具箱4從工具欄中添加一個控件到 Web Forms Page6通過使用腳本元素實例化控件7使用微軟的Ajax內(nèi)容傳送網(wǎng)絡(luò)(CDN)9提供反饋9已知問題9A Reference is not added for System.Web.Ajax.dll9The Extender Wizard does not appear in Visual Studio 2010 when targeting ASP.NET 49Using the AjaxControlToolkit.dll from the Global Assembly Cache10概要This document describes the features of the ASP.NET Ajax Library Beta release. The goal of this release is to give you visibility into our design process, to allow you to test the technology early in the product cycle, and to give you a chance to send us feedback on the implementation.本文檔介紹了ASP.NET Ajax Library Beta版本的功能。這個版本的目的是讓你參與我們的設(shè)計過程，讓您在產(chǎn)品周期前期測試技術(shù)，給你一個機會對我們反饋使用情況。綜述The ASP.NET Ajax Library is a JavaScript library that enables you to build highly interactive Ajax applications. You can use the ASP.NET Ajax Library in both ASP.NET Web Forms and ASP.NET MVC applications. The library is compatible with modern browsers including Microsoft Internet Explorer, Mozilla Firefox, Apple Safari, and Google Chrome.ASP.NET Ajax Library是一個能讓您構(gòu)建高交互性的Ajax應(yīng)用程序的JavaScript庫。你可以在ASP.NET的Web Forms和ASP.NET MVC應(yīng)用ASP.NET Ajax Library。該庫兼容了微軟IE瀏覽器，Mozilla的火狐，蘋果Safari和谷歌Chrome瀏覽器各主流瀏覽器。Using the ASP.NET Ajax Library, you can take advantage of ASP.NET Ajax client controls, client templates, and the client data context to build database-driven Web applications that execute entirely within the Web browser. For example, you can display database data retrieved from a WCF service, an ASP.NET Web service (.asmx), an ADO.NET Data Services service, or any endpoint that can return JSON-formatted data. The ASP.NET Ajax Library lets you both retrieve and modify database data in the client.使用ASP.NET Ajax Library，你可以利用ASP.NET AJAX客戶端控件的優(yōu)勢，客戶端模板，并在客戶端的數(shù)據(jù)范圍內(nèi)建立數(shù)據(jù)庫驅(qū)動的Web應(yīng)用程序，并且在Web瀏覽器內(nèi)執(zhí)行完全。例如，你可以顯示一個WCF服務(wù)，ASP.NET Web服務(wù)（檢索數(shù)據(jù)庫中的數(shù)據(jù)。asmx）的，一個ADO.NET數(shù)據(jù)服務(wù)的服務(wù)，或任何端點，可以返回的JSON格式的數(shù)據(jù)。在ASP.NET Ajax Library可以讓你可以檢索和修改在客戶端數(shù)據(jù)庫中的數(shù)據(jù)。This release of the ASP.NET Ajax Library includes the Ajax Control Toolkit. You can use all the Ajax Control Toolkit controls in an ASP.NET Web Forms application like you use Web server controls or in any ASP.NET MVC or purely client-based Web application by using JavaScript.這個版本的ASP.NET Ajax Library包括了Ajax Control Toolkit。You can use all the Ajax Control Toolkit controls in an ASP.NET Web Forms application like you use Web server controls or in any ASP.NET MVC or purely client-based Web application by using JavaScript.發(fā)布版本包含了什么When you install the Beta release, the following folders and files are created:當(dāng)您安裝了Beta版本，下面的文件夾和文件的創(chuàng)建： Scripts. This is a folder that contains all the ASP.NET Ajax Library JavaScript files.Scripts. 這是一個文件夾包含所有的ASP.NET AJAX Library的JavaScript文件。 Web Forms. This is a folder that contains the two assemblies that are required in order to use the controls from the Ajax Control Toolkit as Web server controls in Web Forms applications (System.Web.Ajax.dll and AjaxControlToolkit.dll).Web Forms. 這是一個文件夾包含兩個在Web Forms applications中使用Ajax Control Toolkit所必需的程序集（System.Web.Ajax.dll和AjaxControlToolkit.dll）。 AspNetAjaxBetaSamples. This is a Visual Studio solution that contains sample code that illustrates how you can use features of the ASP.NET Ajax Library.AspNetAjaxBetaSamples. 這是一個Visual Studio解決方案包含示例代碼演示如何使用ASP.NET AJAX Library的功能。Visual Studio 兼容性The ASP.NET Ajax Library is compatible with Visual Studio 2008 (including Visual Web Developer 2008). The ASP.NET Ajax Library also is compatible with Visual Studio 2010 Beta when targeting ASP.NET 3.5. When using Visual Studio 2010 and targeting ASP.NET 4, you cannot use the Extender Wizard from the Visual Studio Designer. We plan to release a .NET 4 version of the ASP.NET Ajax Library when Visual Studio 2010 is released.ASP.NET Ajax Library與Visual Studio 2008兼容（包括Visual Web Developer 2008）。ASP.NET Ajax Library還與Visual Studio 2010測試版針對ASP.NET 3.5時兼容，。當(dāng)使用Visual Studio 2010和ASP.NET 4，您不能使用Visual Studio設(shè)計器擴展向?qū)?。使用指南，參考文檔和示例代碼To learn how to use the ASP.NET Ajax Library, visit the Ajax Library Web site at the following location: 要了解如何使用ASP.NET Ajax Library，請訪問 Ajax Library網(wǎng)站：http:/www.ASP.net/ajaxLibraryThe Ajax Library Web site includes tutorials, sample code, and sample applications. 該網(wǎng)站包含Ajax Library教程，代碼示例和示例應(yīng)用程序。兼容的瀏覽器This release has been tested on the following browsers. The library might work with other browsers and with other versions of the following browsers as well.此版本已測試以下瀏覽器。該庫或許也可以運行于其他瀏覽器以及以下瀏覽器的其他版本。 Microsoft Internet Explorer 6, 7, and 8 Mozilla Firefox 3 and 3.5 Apple Safari 4 Opera 10 Google Chrome 3如何使用ASP.NET Ajax Library ScriptsThere are two ways that you can use the ASP.NET Ajax Library scripts in a Web application. If you are building an ASP.NET Web Forms application, you can add the controls from the ASP.NET Ajax Library to the Visual Studio Toolbox. You can then add an ASP.NET Ajax control to a Web Forms page simply by dragging the control from the Toolbox.有兩種方法，您可以在Web應(yīng)用程序中使用ASP.NET Ajax Library scripts。如果您要構(gòu)建一個ASP.NET Web窗體應(yīng)用程序，您可以添加ASP.NET Ajax Library的控件到Visual Studio工具箱。然后，您只需從工具箱拖動控制就可以添加一個ASP.NET AJAX控件到Web窗體頁Alternatively, if you are creating an ASP.NET Web Forms application, an ASP.NET MVC application, or any other type of Web application, you can instantiate ASP.NET Ajax controls in JavaScript code.此外，如果你正在創(chuàng)建一個ASP.NET Web窗體應(yīng)用程序，一個ASP.NET MVC應(yīng)用程序，或任何其他類型的Web應(yīng)用程序，你可以實例ASP.NET AJAX控件中的JavaScript代碼。添加ASP.NET Ajax Library到Visual Studio工具箱要添加庫中的控件添加到Visual Studio工具箱，請按照下列步驟：:1) 在Visual Studio中，創(chuàng)建一個新的ASP.NET網(wǎng)站項目或ASP.NET Web應(yīng)用程序項目。.2) 打開Visual Studio設(shè)計器中的Default.aspx頁。 （工具箱根據(jù)不同的文件類型顯示不同的項目，所以你必須打開一個Web窗體頁。）3) 右鍵單擊工具箱，然后單擊添加選項卡。命名新標簽ASP.NET Ajax Library（您可以自由使用任何您所選擇的名稱）。.4) 用鼠標點擊下方的新的ASP.NET Ajax Library選項卡，然后右擊選擇項目.打開選擇工具箱項對話框。5) 點擊瀏覽按鈕，瀏覽到該位置下載的ASP.NET Ajax Library。 6) 在Web Forms文件夾中選擇AjaxControlToolkit.dll程序集，然后單擊確定。.7) 按確定關(guān)閉對話框，選擇更新了的新的控件工具箱。所有的ASP.NET Ajax Library中服務(wù)器控件將出現(xiàn)在工具箱下。 從工具欄中添加一個控件到 Web Forms Page To use the controls, you can drag them from the Toolbox to a page or you can use the Visual Studio Add Extender wizard. For example, to use an ASP.NET Ajax Calendar control in a Web Forms page, follow these steps:若要使用控件，可以從工具箱拖動一個到頁面或者您可以使用Visual Studio中添加擴展向?qū)?。例如，要使用在Web窗體頁ASP.NET Ajax的日歷控件，請按照下列步驟1) 打開一個Web窗體頁并切換到設(shè)計視圖。.2) 從工具箱的標準選項卡，將一個TextBox控件到頁面中。.3) 從ASP.NET Ajax Library的工具箱選項卡，拖動ToolkitScriptManager控件到頁面。當(dāng)你這樣做了，System.Web.Ajax.dll和AjaxControlToolkit.dll組件自動被添加到Web應(yīng)用程序的Bin文件夾中。4) 右鍵單擊該文本框控件，然后單擊添加擴展器。選擇此選項會導(dǎo)致擴展向?qū)С霈F(xiàn)。5) 從向?qū)нx擇CalendarExtender，然后單擊確定。6) 運行該頁面，當(dāng)你將焦點移動到TextBox控件，就會出現(xiàn)一個日歷控件。通過使用腳本元素實例化控件As an alternative to adding the ASP.NET Ajax Library to the Visual Studio Toolbox, you can add a script element to a page and set its src attribute to reference Start.js. For example, you can add the following script element to either an .aspx or .html page:(This example assumes that you have copied the contents of the Scripts folder included in the ASP.NET Ajax Library download into a folder named Scripts in your Web application.)In general, the only JavaScript file that you need to explicitly include in a page is the Start.js file. The Start.js script contains the client script loader that you can use to load all other script files that you need to use in the page.While developing an application, you can add the debug version of the Start.js file, as in the following example: After you add a reference to the Start.js script, you can create and attach an ASP.NET Ajax control to a DOM element by using the Sys.create method. For example, the following page displays a Calendar control whenever you move focus to the input element: Simple Calendar Sys.require(Sponents.calendar, function() Sys.create.calendar(#travelDate); ); 使用微軟的Ajax內(nèi)容傳送網(wǎng)絡(luò)(CDN)This Beta release of the ASP.NET Ajax Library is hosted on the Microsoft Ajax Content Delivery Network (CDN). You can use the ASP.NET Ajax Library directly from the CDN by adding the following script element to a page:Visual Studio 2010 supports IntelliSense from the CDN. (Visual Studio 2008 does not.)提供反饋To provide feedback on the ASP.NET Ajax Library, visit the following forums hosted at the ASP.NET Web site at the following location:/1214.aspx已知問題A Reference is not added for System.Web.Ajax.dllThe AjaxControlToolkit.dll references System.Web.Ajax.dll. In a Web Application Project, if you drag and drop controls from the Toolkit onto the page, a reference to AjaxControlToolkit.dll is added, but not one to System.Web.Ajax.dll. Since both assemblies are actually added to the bin, this does not pose a run-time problem. However, if you subsequently drag a control which depends directly on System.Web.Ajax.dll into the project (AjaxScriptManager is currently the only such control), you will need to add the reference manually. This issue affects both Visual Studio 2008 and Visual Studio 2010.Fix/Recommendation: Existing users of the ACT will not suffer at run-time because both assemblies are in