mcs/class/MicrosoftAjaxLibrary/Readme.htm

   1 <html xmlns:v="urn:schemas-microsoft-com:vml"\r
   2 xmlns="http://www.w3.org/TR/REC-html40" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml">\r
   3 \r
   4 <head>\r
   5 <title> Microsoft AJAX Library 3.5 Readme </title>\r
   6 <style>\r
   7 body\r
   8 {\r
   9     margin-left:.75in;\r
  10     margin-right:2.25in;\r
  11     margin-top:.5in;\r
  12     margin-botton:.25in;\r
  13     font-family:verdana;\r
  14     font-size:10pt;\r
  15 }\r
  16 \r
  17 h1\r
  18 {\r
  19    font-size:20pt;\r
  20    padding-top:.20in;\r
  21    margin-left:-.25in;\r
  22 }\r
  23 \r
  24 h2\r
  25 {\r
  26    font-size:16pt;\r
  27    padding-top:.2in;\r
  28    margin-left:-.25in;\r
  29 }\r
  30 \r
  31 li\r
  32 {\r
  33    margin-top:3pt;\r
  34    margin-botton:6pt;\r
  35 \r
  36 }\r
  37 \r
  38 p.note\r
  39 {\r
  40    margin-left:.5in;\r
  41 }\r
  42 \r
  43 </style>\r
  44 </head>\r
  45 <body>\r
  46 <h1>Microsoft AJAX Library 3.5 Readme</h1>\r
  47 \r
  48 <h2>Overview</h2>\r
  49 \r
  50 <p>For AJAX development, the Microsoft AJAX Library package contains the\r
  51 complete set of client JavaScript resources for ASP.NET AJAX client framework\r
  52 components in ASP.NET 3.5. The Microsoft AJAX Library is primarily intended for these\r
  53 scenarios:</p>\r
  54 \r
  55 <ul>\r
  56         <li>Building client-centric AJAX applications on any platform and with any server-based\r
  57         technology, including those that have\r
  58         no dependency on ASP.NET, such as PHP and ColdFusion.</li>\r
  59         <li>In ASP.NET AJAX applications, using the Microsoft AJAX JavaScript runtime\r
  60         from the file system and not from embedded resources. The <strong>ScriptPath</strong> property\r
  61         of the <strong>ScriptManager</strong> class can be used for this purpose. </li>\r
  62 </ul>\r
  63 \r
  64 <p class="note"><strong>Note</strong> &nbsp;For ASP.NET users, the Microsoft AJAX Library includes the JavaScript resource files that are available to ASP.NET pages that\r
  65 contain a <strong>ScriptManager</strong> server control.</p>\r
  66 \r
  67 <h2>Supported Browsers</h2>\r
  68 <p>The Microsoft AJAX Library package supports the following browsers:</p>\r
  69 <ul>\r
  70         <li>Microsoft Internet Explorer 6.0 and 7.0</li>\r
  71         <li>Mozilla Firefox 1.5 and 2.0</li>\r
  72         <li>Apple Safari 2.0</li>\r
  73         <li>Opera 9</li>\r
  74 </ul>\r
  75 \r
  76 <h2>Known Issues</h2>\r
  77 \r
  78 <p>A bug in ASP.NET 3.5 requires that the script files in\r
  79 the Microsoft AJAX Library have the locale suffix in the file name when referenced by\r
  80 the <strong>ScriptManager</strong> control's <strong>ScriptPath</strong> property.</p>\r
  81 \r
  82 <h3>Problem Description</h3>\r
  83 \r
  84 <p>In ASP.NET, non-default AJAX script files can be used by specifying\r
  85 the <strong>ScriptPath</strong> property of the <strong>ScriptManager</strong> control.\r
  86 The issue is that in some scenarios, the <strong>ScriptManager</strong> control\r
  87 expects the file names to include the locale suffix. For example, there are\r
  88 scenarios where the <strong>ScriptManager</strong> control expects\r
  89 the name MicrosoftAjax.<strong>en-US</strong>.js instead of MicrosoftAjax.js.</p>\r
  90 \r
  91 <h3><strong>Workaround</strong></h3>\r
  92 \r
  93 <p>The Microsoft AJAX Library 3.5 accounts for this bug and ships duplicate files\r
  94 whose name includes the locale suffix. This means that MicrosoftAjax.en-US.js is\r
  95 identical to MicrosoftAjax.js;. MicrosoftAjaxWebForms.js is identical to\r
  96 MicrosoftAjaxWebForms-en.US.js, and so on for the other framework JavaScript\r
  97 (.js) files in the Microsoft AJAX Library.</p>\r
  98 \r
  99 <p>In other scenarios, in the Microsoft AJAX Library 3.5 you can continue to use the\r
 100 files without the locale suffixes, as was the case in the Microsoft AJAX Library 1.0.</p>\r
 101 \r
 102 <h2>Useful Links</h2>\r
 103 <ul>\r
 104 <li>\r
 105         Community Web site: <a href ="http://www.asp.net"> http://www.asp.net </a>\r
 106 </li>\r
 107 <li>\r
 108          Download location: <a href ="http://www.asp.net/ajax/downloads/">http://www.asp.net/ajax/downloads/</a>\r
 109 </li>\r
 110 <li>\r
 111         Documentation: <a href ="http://www.asp.net/ajax/documentation/live/">http://www.asp.net/ajax/documentation/live/</a>\r
 112 </li>\r
 113 <li>\r
 114         Community Forum:\r
 115 \r
 116         <a href="http://forums.asp.net/1007.aspx">http://forums.asp.net/1007.aspx</a>\r
 117 </li>\r
 118 </ul>\r
 119 </body>\r
 120 </html>\r