class/MicrosoftAjaxLibrary/Readme.htm

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