Atlas学习手记（2）：全面了解ScriptManager
2006-07-26 13:04
549 查看
摘要：ScriptManager是Atlas一个重要的控件，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理等。
主要内容[/b]
1．概述
2．Script Management
3．Web Service References
4．Error Handling
5．ScriptManagerProxy
一．概述[/b]
ScriptManager是Atlas一个重要的控件，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理。一个完整的ScriptManager形式如下：
<atlas:ScriptManager
EnablePartialRendering="true|false"
EnableScriptComponents="true|false"
ID="ScriptManager1"
OnPageError="PageError Event Handler"
runat="server"
>
<ErrorTemplate>
<!-- text and HTML elements -->
<span id="errorMessageLabel" runat="server"></span>
<input id="okButton" type="button" value="OK" runat="server" />
</ErrorTemplate>
<Services>
<atlas:ServiceReference
GenerateProxy="true|false"
Path="server path name"
Type="type name"
/>
</Services>
</atlas:ScriptManager>
ScriptManager的属性解释如下：
关于EnablePartialRendering和EnableScriptComponents，我觉得Flier Lu解释的比较透彻：
1．EnablePartialRendering
传统的 Post Back 模式页面，在用户 submit 时会重绘整个页面，并导致浏览器显式的闪烁。而在基于 AJAX 技术的 Altas 框架中，可以通过 UpdatePanel 标签指定需要重绘的局部。这样一来页面在处理请求时，会首先根据 ScriptManager.IsInPartialRenderingMode 属性判断是否在重绘模式中。如果在重绘模式，则仅仅将需要重绘的 UpdatePanel 内容，返回给客户端浏览器，并由 Altas 自动进行内容的更新。通过这种模式，使用者可以在对代码几乎无需修改的情况下，直接享受到 AJAX 带来的客户端用户体验的提升。[/i]
我们也可以通过IsInPartialRenderingMode属性来判断当前页面是否开启了局部更新功能。[/i]
2．EnableScriptComponents
XML [/i]脚本模式是 Altas 引入的基于 XML 的描述性组件定义模型，可以通过一组 XML 标签，定义页面中已有 Web 组件的 AJAX 行为，而无需对现有组件进行修改和调整。而且因为所有的行为都是由 Altas 引擎在客户端动态绑定，所以组件的目标也可不仅仅限于现有的 Web 组件。具体的介绍可以参考 Atlas XML Script。而对于某些特殊情况，例如 ASP.NET 2.0 中的 master 页面，可以通过此属性关闭 XML 脚本支持，以大幅度简化页面的功能，此时 Altas 会自动使用 AtlasRuntime.js替换完整的 Atlas.js 脚本[/i]。
二．Script Management[/b]
Script属性用来包含那些ASP.NET Atlas自带的标准JS库或者是自定义的JS脚本。我们可以使用Path属性来指定一个JS的路径或者使用ScriptName来指定脚本名。ScriptReference示例如下：
<atlas:ScriptManager ID="ScriptManager1" runat="server" >
</atlas:ScriptManager>
ScriptReference的属性如下：
ScriptManager确保每一个脚本只包括一次，试图添加多次将会被忽略。我们也可以使用RegisterScriptReference()方法来添加JS脚本，在使用时要注意添加的JS脚本是否已经存在了。
三． Web Service References[/b]
ServiceReferences指定将通过JS来调用的Web Service，同样它也支持通过Path指定Web Service的路径或者通过Type来指定类型。ServiceReferences示例如下：
<atlas:ScriptManager ID="ScriptManager1" runat="server" >
<Services>
<atlas:ServiceReference Path="MyWebService.asmx"/>
<atlas:ServiceReference Type="MyWebService"/>
</Services>
</atlas:ScriptManager>
ServiceReferences的属性如下：
四．Error Handling[/b]
默认的出错信息应该是Exception.Message，ScriptManager允许通过访问PageErrorEventArgs参数重新在OnPageError中自定义我们的错误信息。我们也可以使用ErrorTemplate来自定义错误信息的显示样式， ErrorTemplate中必须包含如下元素：
注意以上元素的属性不能更改，包括控件的id，完整的ErrorTemplate代码：
<atlas:ScriptManager ID="ScriptManager1" EnablePartialRendering="true" OnPageError="Page_ErrorHandler" runat="server">
<ErrorTemplate>
<div>
<p><span id="errorMessageLabel" runat="server"></span></p>
<p><input id="okButton" type="button" value="OK" runat="server"/></p>
</div>
</ErrorTemplate>
</atlas:ScriptManager>
看一下Atlas网站提供的一个完整的例子：
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>"Atlas" Error Handling</title>
<atlas:ScriptManager ID="ScriptManager1" EnablePartialRendering="true" OnPageError="Page_ErrorHandler"
runat="server">
<ErrorTemplate>
<div style="width: 450px; height: 300px; padding: 10px; border: solid 3px black;
background: #ffd; text-align: left;">
<h1>
Server Error</h1>
<p>
An unhandled exception with the following message has occured on the server:</p>
<p>
<span id="errorMessageLabel" runat="server"></span>
</p>
<p>
<input id="okButton" type="button" value="OK" runat="server" /></p>
</div>
</ErrorTemplate>
</atlas:ScriptManager>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>
"Atlas" Error Handling</h1>
<p>
This example demonstrates the use of an <code>ErrorTemplate</code> and a <code>PageError</code>
handler, to display a custom error message when an unhandled exception occurs on
the server.</p>
<atlas:UpdatePanel ID="Panel1" Mode="Always" runat="server">
<ContentTemplate>
<p>
Server time:
<%= DateTime.Now.ToString() %>
</p>
<p>
<asp:Button ID="UpdateButton" Text="Update Time" runat="server" />
<asp:Button ID="ErrorButton" Text="Error" OnClick="ErrorButton_Click" runat="server" /></p>
</ContentTemplate>
</atlas:UpdatePanel>
</div>
</form>
</body>
</html>
运行后单击Error按钮，会出现如下界面：
<atlas:ScriptManager runat="server" ID="ScriptManager1" EnablePartialRendering="true" />
Content-page：
<atlas:ScriptManagerProxy runat="server" ID="ScriptManagerProxy1">
</atlas:ScriptManagerProxy>
完整的示例可以参见Atlas网站。
关于Atlas的ScriptManager介绍就到这里了，本人也是刚开始接触Atlas，希望能跟大家共同交流，这样我的Atlas学习之旅也许会轻松一些。
完整示例下载
主要内容[/b]
1．概述
2．Script Management
3．Web Service References
4．Error Handling
5．ScriptManagerProxy
一．概述[/b]
ScriptManager是Atlas一个重要的控件，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理。一个完整的ScriptManager形式如下：
<atlas:ScriptManager
EnablePartialRendering="true|false"
EnableScriptComponents="true|false"
ID="ScriptManager1"
OnPageError="PageError Event Handler"
runat="server"
>
<ErrorTemplate>
<!-- text and HTML elements -->
<span id="errorMessageLabel" runat="server"></span>
<input id="okButton" type="button" value="OK" runat="server" />
</ErrorTemplate>
<Services>
<atlas:ServiceReference
GenerateProxy="true|false"
Path="server path name"
Type="type name"
/>
</Services>
</atlas:ScriptManager>
ScriptManager的属性解释如下：
| 属性名[/b] | 说明[/b] |
| EnablePartialRendering | 是否开启页面局部更新功能，默认值为false EnablePartialRendering="true|false[/b]" |
| EnableScriptComponents | 是否启用XML脚本模式，默认值为true EnableScriptComponents="true[/b]|false" |
| ID | 控件ID ID="ScriptManager1" |
| OnPageError | 页面错误处理，后面会详细讲到 OnPageError="PageError Event Handler" |
| runat | 总是runat="server" |
1．EnablePartialRendering
传统的 Post Back 模式页面，在用户 submit 时会重绘整个页面，并导致浏览器显式的闪烁。而在基于 AJAX 技术的 Altas 框架中，可以通过 UpdatePanel 标签指定需要重绘的局部。这样一来页面在处理请求时，会首先根据 ScriptManager.IsInPartialRenderingMode 属性判断是否在重绘模式中。如果在重绘模式，则仅仅将需要重绘的 UpdatePanel 内容，返回给客户端浏览器，并由 Altas 自动进行内容的更新。通过这种模式，使用者可以在对代码几乎无需修改的情况下，直接享受到 AJAX 带来的客户端用户体验的提升。[/i]
我们也可以通过IsInPartialRenderingMode属性来判断当前页面是否开启了局部更新功能。[/i]
2．EnableScriptComponents
XML [/i]脚本模式是 Altas 引入的基于 XML 的描述性组件定义模型，可以通过一组 XML 标签，定义页面中已有 Web 组件的 AJAX 行为，而无需对现有组件进行修改和调整。而且因为所有的行为都是由 Altas 引擎在客户端动态绑定，所以组件的目标也可不仅仅限于现有的 Web 组件。具体的介绍可以参考 Atlas XML Script。而对于某些特殊情况，例如 ASP.NET 2.0 中的 master 页面，可以通过此属性关闭 XML 脚本支持，以大幅度简化页面的功能，此时 Altas 会自动使用 AtlasRuntime.js替换完整的 Atlas.js 脚本[/i]。
二．Script Management[/b]
Script属性用来包含那些ASP.NET Atlas自带的标准JS库或者是自定义的JS脚本。我们可以使用Path属性来指定一个JS的路径或者使用ScriptName来指定脚本名。ScriptReference示例如下：
<atlas:ScriptManager ID="ScriptManager1" runat="server" >
</atlas:ScriptManager>
ScriptReference的属性如下：
| 属性[/b] | 描述[/b] |
| Path | 自定义JS脚本的路径 Path="MyCustom.js" |
| ScriptName | 指定标准库中的JS脚本名，其中可以指定的有：AtlasUIDragDrop、AtlasUIGlitz、AtlasUIMap、AtlasWebParts ScriptName="AtlasUIDragDrop" |
| Browser | 指定脚本适用的浏览器 |
三． Web Service References[/b]
ServiceReferences指定将通过JS来调用的Web Service，同样它也支持通过Path指定Web Service的路径或者通过Type来指定类型。ServiceReferences示例如下：
<atlas:ScriptManager ID="ScriptManager1" runat="server" >
<Services>
<atlas:ServiceReference Path="MyWebService.asmx"/>
<atlas:ServiceReference Type="MyWebService"/>
</Services>
</atlas:ScriptManager>
ServiceReferences的属性如下：
| 属性[/b] | 描述[/b] |
| Path | 指定.asmx的路径 <atlas:ServiceReference Path="MyWebService.asmx"/> |
| Type | 指定Web Service的类型 <atlas:ServiceReference Type="MyWebService"/> |
| GenerateProxy | 是否生成客户端脚本的代理 GenerateProxy="true" |
默认的出错信息应该是Exception.Message，ScriptManager允许通过访问PageErrorEventArgs参数重新在OnPageError中自定义我们的错误信息。我们也可以使用ErrorTemplate来自定义错误信息的显示样式， ErrorTemplate中必须包含如下元素：
| 控件/元素[/b] | 属性[/b] | 说明[/b] |
| Button | id="okButton" runat="server" | 用来关闭错误信息 |
| <span>或者<div> | id="errorMessageLabel" runat="server" | 显示错误信息 |
<atlas:ScriptManager ID="ScriptManager1" EnablePartialRendering="true" OnPageError="Page_ErrorHandler" runat="server">
<ErrorTemplate>
<div>
<p><span id="errorMessageLabel" runat="server"></span></p>
<p><input id="okButton" type="button" value="OK" runat="server"/></p>
</div>
</ErrorTemplate>
</atlas:ScriptManager>
看一下Atlas网站提供的一个完整的例子：
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>"Atlas" Error Handling</title>
<atlas:ScriptManager ID="ScriptManager1" EnablePartialRendering="true" OnPageError="Page_ErrorHandler"
runat="server">
<ErrorTemplate>
<div style="width: 450px; height: 300px; padding: 10px; border: solid 3px black;
background: #ffd; text-align: left;">
<h1>
Server Error</h1>
<p>
An unhandled exception with the following message has occured on the server:</p>
<p>
<span id="errorMessageLabel" runat="server"></span>
</p>
<p>
<input id="okButton" type="button" value="OK" runat="server" /></p>
</div>
</ErrorTemplate>
</atlas:ScriptManager>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>
"Atlas" Error Handling</h1>
<p>
This example demonstrates the use of an <code>ErrorTemplate</code> and a <code>PageError</code>
handler, to display a custom error message when an unhandled exception occurs on
the server.</p>
<atlas:UpdatePanel ID="Panel1" Mode="Always" runat="server">
<ContentTemplate>
<p>
Server time:
<%= DateTime.Now.ToString() %>
</p>
<p>
<asp:Button ID="UpdateButton" Text="Update Time" runat="server" />
<asp:Button ID="ErrorButton" Text="Error" OnClick="ErrorButton_Click" runat="server" /></p>
</ContentTemplate>
</atlas:UpdatePanel>
</div>
</form>
</body>
</html>
运行后单击Error按钮，会出现如下界面：
<atlas:ScriptManager runat="server" ID="ScriptManager1" EnablePartialRendering="true" />
Content-page：
<atlas:ScriptManagerProxy runat="server" ID="ScriptManagerProxy1">
</atlas:ScriptManagerProxy>
完整的示例可以参见Atlas网站。
关于Atlas的ScriptManager介绍就到这里了，本人也是刚开始接触Atlas，希望能跟大家共同交流，这样我的Atlas学习之旅也许会轻松一些。
完整示例下载
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Atlas学习手记（2）：全面了解ScriptManager [转]
- Atlas学习手记（2）：全面了解ScriptManager
- Atlas学习手记（2）：全面了解ScriptManager
- Atlas学习手记（2）：全面了解ScriptManager
- Atlas学习手记（2）：全面了解ScriptManager
- Atlas学习手记系列(转)
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Atlas学习手记（22）：使用行为增强用户界面（二）：Floating Behavior
- Atlas学习手记（8）：调用本地Web Service简单介绍
- Atlas学习手记（12）：使用CascadingDropDown控件
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它） 分类： Android 2015-07-04 21:40 17人阅读 评论(0) 收藏
- 更加全面的ASP.NET AJAX(Atlas)学习、参考资源（英文）
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Atlas学习手记系列
- Android 通知栏Notification的整合 全面学习 （一个DEMO让你完全了解它）
- Atlas学习手记（10）：使用AlwaysVisibleControl Extender