# Microsoft AJAX Library 3.5 Readme

## Overview

For AJAX development, the Microsoft AJAX Library package contains the complete set of client JavaScript resources for ASP.NET AJAX client framework components in ASP.NET 3.5. The Microsoft AJAX Library is primarily intended for these scenarios:

- Building client-centric AJAX applications on any platform and with any server-based technology, including those that have no dependency on ASP.NET, such as PHP and ColdFusion.
- In ASP.NET AJAX applications, using the Microsoft AJAX JavaScript runtime from the file system and not from embedded resources. The ScriptPath property of the ScriptManager class can be used for this purpose.

Note For ASP.NET users, the Microsoft AJAX Library includes the JavaScript resource files that are available to ASP.NET pages that contain a ScriptManager server control.

## Supported Browsers

The Microsoft AJAX Library package supports the following browsers:

- Microsoft Internet Explorer 6.0 and 7.0
- Mozilla Firefox 1.5 and 2.0
- Apple Safari 2.0
- Opera 9

## Known Issues

A bug in ASP.NET 3.5 requires that the script files in the Microsoft AJAX Library have the locale suffix in the file name when referenced by the ScriptManager control's ScriptPath property.

### Problem Description

In ASP.NET, non-default AJAX script files can be used by specifying the ScriptPath property of the ScriptManager control. The issue is that in some scenarios, the ScriptManager control expects the file names to include the locale suffix. For example, there are scenarios where the ScriptManager control expects the name MicrosoftAjax.en-US.js instead of MicrosoftAjax.js.

### Workaround

The Microsoft AJAX Library 3.5 accounts for this bug and ships duplicate files whose name includes the locale suffix. This means that MicrosoftAjax.en-US.js is identical to MicrosoftAjax.js;. MicrosoftAjaxWebForms.js is identical to MicrosoftAjaxWebForms-en.US.js, and so on for the other framework JavaScript (.js) files in the Microsoft AJAX Library.

In other scenarios, in the Microsoft AJAX Library 3.5 you can continue to use the files without the locale suffixes, as was the case in the Microsoft AJAX Library 1.0.

## Useful Links

- Community Web site: http://www.asp.net
- Download location: http://www.asp.net/ajax/downloads/
- Documentation: http://www.asp.net/ajax/documentation/live/
- Community Forum: http://forums.asp.net/1007.aspx