AspNetAjaxLibrary0911版本 翻译by hongwise.doc

ASP.NET Ajax Library Beta version 0911Release Notes(发步说明)概要1综述2发布版本包含了什么2Visual Studio 兼容性3使用指南，参考文档和示例代码3兼容的浏览器4如何使用ASP.NET Ajax Library Scripts4添加ASP.NET Ajax Library到Visual Studio工具箱4从工具栏中添加一个控件到 Web Forms Page6通过使用脚本元素实例化控件7使用微软的Ajax内容传送网络(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版本的功能。这个版本的目的是让你参与我们的设计过程，让您在产品周期前期测试技术，给你一个机会对我们反馈使用情况。综述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是一个能让您构建高交互性的Ajax应用程序的JavaScript库。你可以在ASP.NET的Web Forms和ASP.NET MVC应用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客户端控件的优势，客户端模板，并在客户端的数据范围内建立数据库驱动的Web应用程序，并且在Web浏览器内执行完全。例如，你可以显示一个WCF服务，ASP.NET Web服务（检索数据库中的数据。asmx）的，一个ADO.NET数据服务的服务，或任何端点，可以返回的JSON格式的数据。在ASP.NET Ajax Library可以让你可以检索和修改在客户端数据库中的数据。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.发布版本包含了什么When you install the Beta release, the following folders and files are created:当您安装了Beta版本，下面的文件夹和文件的创建： 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时兼容，。当使用Visual Studio 2010和ASP.NET 4，您不能使用Visual Studio设计器扩展向导。使用指南，参考文档和示例代码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网站：http:/www.ASP.net/ajaxLibraryThe Ajax Library Web site includes tutorials, sample code, and sample applications. 该网站包含Ajax Library教程，代码示例和示例应用程序。兼容的浏览器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应用程序中使用ASP.NET Ajax Library scripts。如果您要构建一个ASP.NET Web窗体应用程序，您可以添加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.此外，如果你正在创建一个ASP.NET Web窗体应用程序，一个ASP.NET MVC应用程序，或任何其他类型的Web应用程序，你可以实例ASP.NET AJAX控件中的JavaScript代码。添加ASP.NET Ajax Library到Visual Studio工具箱要添加库中的控件添加到Visual Studio工具箱，请按照下列步骤：:1) 在Visual Studio中，创建一个新的ASP.NET网站项目或ASP.NET Web应用程序项目。.2) 打开Visual Studio设计器中的Default.aspx页。 （工具箱根据不同的文件类型显示不同的项目，所以你必须打开一个Web窗体页。）3) 右键单击工具箱，然后单击添加选项卡。命名新标签ASP.NET Ajax Library（您可以自由使用任何您所选择的名称）。.4) 用鼠标点击下方的新的ASP.NET Ajax Library选项卡，然后右击选择项目.打开选择工具箱项对话框。5) 点击浏览按钮，浏览到该位置下载的ASP.NET Ajax Library。 6) 在Web Forms文件夹中选择AjaxControlToolkit.dll程序集，然后单击确定。.7) 按确定关闭对话框，选择更新了的新的控件工具箱。所有的ASP.NET Ajax Library中服务器控件将出现在工具箱下。 从工具栏中添加一个控件到 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中添加扩展向导。例如，要使用在Web窗体页ASP.NET Ajax的日历控件，请按照下列步骤1) 打开一个Web窗体页并切换到设计视图。.2) 从工具箱的标准选项卡，将一个TextBox控件到页面中。.3) 从ASP.NET Ajax Library的工具箱选项卡，拖动ToolkitScriptManager控件到页面。当你这样做了，System.Web.Ajax.dll和AjaxControlToolkit.dll组件自动被添加到Web应用程序的Bin文件夹中。4) 右键单击该文本框控件，然后单击添加扩展器。选择此选项会导致扩展向导出现。5) 从向导选择CalendarExtender，然后单击确定。6) 运行该页面，当你将焦点移动到TextBox控件，就会出现一个日历控件。通过使用脚本元素实例化控件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内容传送网络(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