ASP.NET AJAX入门系列（2）：使用ScriptManager控件

最新推荐文章于 2016-01-08 15:33:51 发布
最新推荐文章于 2016-01-08 15:33:51 发布
阅读量457 收藏
点赞数
分类专栏： ASP.NET AJAX入门系列 文章标签： asp.net ajax server webservice 脚本 javascript

ScriptManager控件包括在ASP.NET 2.0 AJAX Extensions中，它用来处理页面上的所有组件以及页面局部更新，生成相关的客户端代理脚本以便能够在JavaScript中访问Web Service，所有需要支持ASP.NET AJAX的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，以及调用AuthenticationService和ProfileService，还有页面错误处理等。

 

主要内容

1．控件概述

2．一个简单的示例

3．客户端脚本模式

4．错误处理

5．Services属性

6．Scripts属性

 

一．控件概述

ScriptManager控件包括在ASP.NET 2.0 AJAX Extensions中，它用来处理页面上的所有组件以及页面局部更新，生成相关的客户端代理脚本以便能够在JavaScript中访问Web Service，所有需要支持ASP.NET AJAX的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理等。

使用<asp:ScriptManager/>来定义一个ScriptManager，简单的ScriptManager定义形式：

 

 

< asp:ScriptManager  ID ="ScriptManager1"  

                   runat ="server" >

       < AuthenticationService  Path =""   />

       < ProfileService  LoadProperties =""  Path =""   />

       < Scripts >

        <asp:ScriptReference/>

       </ Scripts >

       < Services >

         < asp:ServiceReference  />

       </ Services >

</ asp:ScriptManager >
ScriptManager 属性和方法如下：

 

属性/方法

描述

AllowCustomError

和Web.config中的自定义错误配置区<customErrors>相联系，是否使用它，默认值为true

AsyncPostBackErrorMessage

异步回传发生错误时的自定义提示错误信息，

AsyncPostBackTimeout

异步回传时超时限制，默认值为90，单位为秒

EnablePartialRendering

是否支持页面的局部更新，默认值为True，一般不需要修改

ScriptMode

指定ScriptManager发送到客户端的脚本的模式，有四种模式：Auto，Inherit，Debug，Release，默认值为Auto，后面会仔细说到。

ScriptPath

设置所有的脚本块的根目录，作为全局属性，包括自定义的脚本块或者引用第三方的脚本块。如果在Scripts中的<asp:ScriptReference/>标签中设置了Path属性，它将覆盖该属性。

OnAsyncPostBackError

异步回传发生异常时的服务端处理函数，在这里可以捕获一场信息并作相应的处理。

OnResolveScriptReference

指定ResolveScriptReference事件的服务器端处理函数，在该函数中可以修改某一条脚本的相关信息如路径、版本等。

 

二．一个简单的示例

这个例子其实是UpdatePanel示例，在页面中加入了日期控件和一个下拉框，根据下拉框选择的不同，日期控件背景变为不同的颜色。示例代码如下：

 

<% @ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default"  %>

 

 < script  runat ="server" >

    void DropDownSelection_Change(Object sender, EventArgs e)

    {

        Calendar1.DayStyle.BackColor =

            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

    }

 </ script >

 

 < html  xmlns ="http://www.w3.org/1999/xhtml" >

< head  id ="Head1"  runat ="server" >

     < title > ScriptManager Example </ title >

</ head >

< body >

     < form  id ="form1"  runat ="server" >

         < div >

             < asp:ScriptManager  ID ="ScriptManager1"  

                               runat ="server" >

             </ asp:ScriptManager >

             < asp:UpdatePanel  ID ="UpdatePanel1"

                             runat ="server" >

                 < ContentTemplate >

                     < asp:Calendar  ID ="Calendar1"  

                                  ShowTitle ="True"

                                  runat ="server"   />

                     < div >

                        Background:

                         < br  />

                         < asp:DropDownList  ID ="ColorList"  

                                          AutoPostBack ="True"  

                                          OnSelectedIndexChanged ="DropDownSelection_Change"

                                          runat ="server" >

                             < asp:ListItem  Selected ="True"  Value ="White" >  

                            White  </ asp:ListItem >

                             < asp:ListItem  Value ="Silver" >  

                            Silver  </ asp:ListItem >

                             < asp:ListItem  Value ="DarkGray" >  

                            Dark Gray  </ asp:ListItem >

                             < asp:ListItem  Value ="Khaki" >  

                            Khaki  </ asp:ListItem >

                             < asp:ListItem  Value ="DarkKhaki" >  D

                            ark Khaki  </ asp:ListItem >

                         </ asp:DropDownList >

                     </ div >

                 </ ContentTemplate >

             </ asp:UpdatePanel >

             < br  />

         </ div >

     </ form >

</ body >

</ html >

 

三．客户端脚本模式

在前面我们提到了ScriptMode属性指定ScriptManager发送到客户端的脚本的模式，它有四种模式：Auto，Inherit，Debug，Release，默认值为Auto。

1．Auto：它会根据Web站点的Web.config配置文件来决定使用哪一种模式，只有当配置文件中retail属性设置为false:．Inherit：应该是通过程序设置ScriptMode的时候，等同于Auto？（不太了解）

< system .web >

   < deployment  retail ="false"   />

</ system.web >

或者页面中的Debug指令设为true的时候会使用Debug版本，其他的情况都会使用Release版本。

< %@ Page  Language ="C#"  Debug ="true"

AutoEventWireup ="true"  CodeFile ="Default.aspx.cs"  Inherits ="_Default"  % >

2

3．Debug：客户端脚本使用Debug版本，除非retail属性设为true。

4．Release：客户端脚本使用Release版本，除非retail属性设为false。

 

四．错误处理

在页面回传时如果发生了异常AsyncPostBackError事件将被触发，错误信息的处理依赖于AllowCustomErrors属性、AsyncPostBackErrorMessage属性和Web.config中的<customErrors>配置区。下面看一个简单的错误处理例子，在AsyncPostBackError事件中捕获到异常信息并设置AsyncPostBackErrorMessage属性。

 

<% @ Page Language="C#"  %>

< script  runat ="server" >

    protected void ErrorProcessClick_Handler(object sender, EventArgs e)

    {
        // This handler demonstrates an error condition. In this example

        // the server error gets intercepted on the client and an alert is shown. 

        throw new ArgumentException();
    }

    protected void SuccessProcessClick_Handler(object sender, EventArgs e)

    {
        // This handler demonstrates no server side exception.

        UpdatePanelMessage.Text = "The asynchronous postback completed successfully.";

    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)

    {
        ScriptManager1.AsyncPostBackErrorMessage = "异常信息为：" + e.Exception.Message;

    }

 </ script >


< html  xmlns ="http://www.w3.org/1999/xhtml" >

< head  id ="Head1"  runat ="server" >

     < title > PageRequestManager endRequestEventArgs Example </ title >

     < style  type ="text/css" >

    body {

        font-family: Tahoma;

    }

    #AlertDiv{

    left: 40%; top: 40%;

    position: absolute; width: 200px;

    padding: 12px; 

    border: #000000 1px solid;

    background-color: white; 

    text-align: left;

    visibility: hidden;

    z-index: 99;

    }

    #AlertButtons{

    position: absolute;

    right: 5%;

    bottom: 5%;

    }

     </ style >

</ head >

< body  id ="bodytag" >

     < form  id ="form1"  runat ="server" >

         < div >

             < asp:ScriptManager  ID ="ScriptManager1"  runat ="server"  
            OnAsyncPostBackError ="ScriptManager1_AsyncPostBackError" >

             </ asp:ScriptManager >
 
             < script  type ="text/javascript"  language ="javascript" >

                var divElem = 'AlertDiv';

                var messageElem = 'AlertMessage';

                var errorMessageAdditional = 'Please try again.';

                var bodyTag = 'bodytag';
                Sys.WebForms.PageRequestManager.getInstance().add_endRequest(EndRequestHandler);

                function ToggleAlertDiv(visString)
                {
                     if (visString == 'hidden')

                     {
                         $get(bodyTag).style.backgroundColor = 'white';                         
                     }
                     else
                     {
                         $get(bodyTag).style.backgroundColor = 'gray';                         

                     }

                     var adiv = $get(divElem);

                     adiv.style.visibility = visString;

                }

                function ClearErrorState() {

                     $get(messageElem).innerHTML = '';

                     ToggleAlertDiv('hidden');                     

                }
                function EndRequestHandler(sender, args)

                {
                   if (args.get_error() != undefined && args.get_error().httpStatusCode == '500')
                   {

                       var errorMessage = args.get_error().message

                       args.set_errorHandled(true);

                       ToggleAlertDiv('visible');

                       $get(messageElem).innerHTML = '"' + 

                                errorMessage + '" ' + errorMessageAdditional;

                   }

                }

             </ script >

             < asp:UpdatePanel  runat ="Server"  UpdateMode ="Conditional"  ID ="UpdatePanel1" >

                 < ContentTemplate >

                     < asp:Panel  ID ="Panel1"  runat ="server"  GroupingText ="Update Panel" >

                         < asp:Label  ID ="UpdatePanelMessage"  runat ="server"   />

                         < br  />

                        Last update:

                         <% =  DateTime.Now.ToString()  %>

                        .

                         < br  />

                         < asp:Button  runat ="server"  ID ="Button1"  Text ="Submit Successful Async Postback"

                            OnClick ="SuccessProcessClick_Handler"  OnClientClick ="ClearErrorState()"   />

                         < asp:Button  runat ="server"  ID ="Button2"  Text ="Submit Async Postback With Error"

                            OnClick ="ErrorProcessClick_Handler"  OnClientClick ="ClearErrorState()"   />

                         < br  />

                     </ asp:Panel >

                 </ ContentTemplate >

             </ asp:UpdatePanel >

             < div  id ="AlertDiv" >

                 < div  id ="AlertMessage" >

                 </ div >

                 < br  />

                 < div  id ="AlertButtons"   >

                     < input  id ="OKButton"  type ="button"  value ="OK"  

                           runat ="server"  onclick ="ClearErrorState()"   />

                 </ div >

            </ div >

     </ form >

</ body >

</ html >

运行后时界面：

发生异常信息：

 

五．Services属性

Services用来管理对WebService的调用，通过<asp:ServiceReference>标签可以在Services中注册一个WebService，在运行时ScriptManager将为每一个ServiceReference对象生成一个客户端代理，<asp:ServiceReference>标签一个很重要的属性是Path，用来指定WebService的路径，如下所示：

< asp:ScriptManager  ID ="SM1"  runat ="server" >

     < Services >

         < asp:ServiceReference  Path ="Service.asmx" />

     </ Services >

</ asp:ScriptManager >

看一个简单的调用WebService的例子：

WebService如下，注意在WebServiceSample上加ScriptService特性：页面：

[ScriptService]

 public   class  WebServiceSample : System.Web.Services.WebService  {

    public WebServiceSample()

    {

        //Uncomment the following line if using designed components 

        //InitializeComponent(); 

    }


    [WebMethod]

    public string EchoString(String s)

    {
        return "Hello " + s;
    }

}

ASPX

 

<% @ Page Language="C#" AutoEventWireup="true" CodeFile="Default3.aspx.cs" Inherits="Default3"  %>

< html  xmlns ="http://www.w3.org/1999/xhtml"   >

< head  runat ="server" >

     < title > Untitled Page </ title >

</ head >

< script  type ="text/javascript"  language ="JavaScript" >

    function OnbuttonGo_click() 

    {
        requestSimpleService = WebServiceSample.EchoString(

            document.getElementById('inputName').value,       //params

            OnRequestComplete    //Complete event

            );

        return false;
    }

    function OnRequestComplete(result) 

    {
        alert(result);
    }

 </ script >

< body >

     < form  id ="form1"  runat ="server" >

     < asp:ScriptManager  ID ="ScriptManager1"  runat ="server" >

         < Services >

             < asp:ServiceReference  Path ="WebServiceSample.asmx" />

         </ Services >

     </ asp:ScriptManager >

     < div >

         < input  type ="text"  id ="inputName"  size =20 />

         < input  id ="button"  type ="button"  value ="调 用"  onclick ="return OnbuttonGo_click()"   /></ div >

     </ form >

</ body >

</ html >

运行后效果如下：

当然了也可以在运行时动态的在Services中加入ServiceReference，下面看一个运行时动态加入ServiceReference的例子：

<% @ Page Language="C#" AutoEventWireup="true" CodeFile="Default3.aspx.cs" Inherits="Default3"  %>

< script  runat ="server" >

    void Page_Load(object sender, EventArgs e)

    {

        ServiceReference sr = new ServiceReference();

        sr.Path = "WebServiceSample.asmx";

        ScriptManager1.Services.Add(sr);

    }

 </ script >

< html  xmlns ="http://www.w3.org/1999/xhtml"   >

< head  runat ="server" >

     < title > Untitled Page </ title >

</ head >

< script  type ="text/javascript"  language ="JavaScript" >

    function OnbuttonGo_click() 

    {

        requestSimpleService = WebServiceSample.EchoString(

            document.getElementById('inputName').value,       //params

            OnRequestComplete    //Complete event

            );

        return false;

    }

 

    function OnRequestComplete(result) 

    {

        alert(result);

    }

 </ script >

 

 < body >

    

     < form  id ="form1"  runat ="server" >

     < asp:ScriptManager  ID ="ScriptManager1"  runat ="server" >

     </ asp:ScriptManager >

     < div >

         < input  type ="text"  id ="inputName"  size =20 />

         < input  id ="button"  type ="button"  value ="调 用"  onclick ="return OnbuttonGo_click()"   /></ div >

     </ form >

</ body >

</ html >

可以看到运行后和在ScriptManager中直接加入的效果是一样的。

 

六．Scripts属性

关于Scripts属性到后面具体再说吧，最主要的属性有Path指定脚本的路径，ScriptMode指定客户端脚本的模式，它会覆盖ScriptManager中的ScriptMode属性，还有一个属性是IgnoreScriptPath，指定是否忽略掉ScriptManager中的ScriptPath属性。

关于ScriptManager控件就学习到这里了，至于AuthenticationService属性和ProfileService属性都很简单。

示例代码下载：http://files.cnblogs.com/Terrylee/ASPNETAJAXScriptManagerDemo.rar

kangzerun
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
ScriptManager的简单用法-ASP.Net 中ASP:ScriptManager控件的使用
xuanmu
03-17 1537
资料中如实是说: 1, ScriptManager(脚本控制器)是asp.net ajax存在的基础. 2, 一个页面只允许有一个ScriptManager,并且放在其他ajax控件的前面. 3,ScriptManager掌管着客户端Ajax页的多有脚本,并在页面中注册Ajax类库,用来实现页面的局部更新和对Web服务的调用. 下面是scriptManager...
AJAX——ASP.NET AJAX框架（一）ScriptManager
热门推荐
学会改变自己——才能突破
12-16 1万+
前边我们针对以XMLHttpRequest为核心学习了AJAX的相关知识，接下来，重点学习一下微软在ASP.NET中的AJAX的框架的基础学习，主要是AJAX Extension中的几个控件，如下图:     而，这篇博客，我们来重点看一下ScriptManager的学习。而我主要是通过他的属性来进行学习的。            一，概述：ScriptManager控件包括在ASP
ScriptManager控件的使用(ASP.NET Web)
07-06
ScriptManager控件的应用示例(ASP.NET Web)
初学 ASP.NET AJAX (二)：小试 ScriptManager
夏风鱼的专栏
11-02 885
1 概述ScriptManager 控件管理用于 Microsoft ASP.NET AJAX 页面的客户端脚本。默认情况下，ScriptManager 控件将 Microsoft AJAX 库的脚本与页面注册到一起，这使脚本可以使用类型系统扩展并支持局部页面输出和 Web 服务调用。在页面中，必须使用 ScriptManager 控件来使下列 Microsoft ASP.NET AJAX 的
ASP[1].NET_AJAX入门系列：使用ScriptManager控件
04-20
ASP[1].NET_AJAX入门系列：使用ScriptManager控件.doc
ASP.NET_AJAX入门系列
10-08
ASP.NET_AJAX入门系列：使用ScriptManager控件.doc ASP.NET_AJAX入门系列：使用UpdatePanel控件.doc ASP.NET_AJAX入门系列：使用客户端脚本对UpdateProgress编程.doc ASP.NET_AJAX入门系列：在多个UpdatePanle中使用...
asp.net使用母版页中使用ajax脚本取数据
01-20
代码如下: <asp ID=”smMaster” runat=”server” ScriptMode=”Auto” EnablePageMethods=”true”> </asp> 2、在Master源码中编写js 代码如下: function NetPost() { //创建实例 var wRequest = new Sys.Net....
ASP.NET AJAX核心控件示例
01-10
主要介绍了ASP.NET AJAX的几个核心控件的作用和具体用法示例。 包括：Scriptmanager，Updatepanal，Updateprogress，Timer
ASP.NET AJAX 1.0 RC开发10分钟图解
01-20
开发环境：VS2005+ASP.NET AJAX 1.0 RC ...2.可以看到左侧工具箱多了一个AJAX Extensions，下面包括Timer,ScriptManager,ScriptManagerProxy,UpdateProgress,UpdatePanel等几个控件，右侧的代码视图，可以看到
服务器标记“asp-ScriptManager”不明确解决参考.docx
09-27
服务器标记“asp-ScriptManager”不明确解决参考.docx
使用ScriptManager控件实例代码
11-19
使用ScriptManager控件实例代码
ASP.NET - ScriptManager 控件概述
dodream的专栏
12-22 1574
      ScriptManager 控件管理支持 AJAX 的 ASP.NET 网页的客户端脚本。默认情况下，ScriptManager 控件会向页面注册 Microsoft AJAX Library 的脚本。这将使客户端脚本能够使用类型系统扩展并支持部分页呈现和 Web 服务调用这样的功能。 必须在页上使用 ScriptManager 控件，以启用下列 ASP.NET 的 AJA
全面了解ScriptManager
wzrjyq的专栏
05-17 857
 全面了解ScriptManager摘要：ScriptManager是Atlas一个重要的控件，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页
ScriptManager 和 ScriptManagerProxy
weixin_30823227的博客
09-27 120
ScriptManager是Atlas一个重要的控件，它用来处理页面上的所有Atlas组件以及局部页面的更新，生成相关的客户端脚本，所有需要支持Atlas的ASP.NET页面上有且只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库，或者指定通过JS来调用的Web Service，还可以指定页面错误处理等。 ScriptManager ...
ScriptManager 控件概述
大数据训练营
06-28 6823
原文 http://msdn.microsoft.com/zh-cn/library/bb398863.aspx ScriptManager 控件管理支持 AJAX 的 ASP.NET 网页的客户端脚本。 默认情况下，ScriptManager 控件会向页面注册 Microsoft AJAX Library 的脚本。 这将使客户端脚本能够使用类型系统扩展并支持部分页呈现和
ASP.NET 第八季 ajax技术
02-17
主讲内容：第一讲 asp.net ajax简介第二讲 ScriptManager脚本管理控件第三讲 ScriptManager脚本管理控件 (2)第四讲 UpdatePanel局部更新控件第五讲 Timer定时器控件实例
【ASP.NET】利用UpdatePanel与ScriptManager完成局部的更新
编程记录，亲测有效
01-08 9886
ASP.NET中不仅可以像其它网页一样通过《【ASP.NET】利用jQuery与.ashx完成简单的Ajax》（点击打开链接）完成简单的局部更新， 在ASP.NET2.0版本（不含）之后，基本上在其ASP.NET3.5版本（含）开始，推出了一些列Ajax Extensions的组件，可以通过ASP.NET自身封装好的方法实现局部更新。可能比较新的缘故，网上对此的资料比较少，而且写得天花乱坠。
ScriptManager控件
Jacky的专栏
11-02 565
ScriptManager控件   2011-10-21 21:01:23|  分类： 默认分类|举报|字号 订阅 ScriptManager的简单用法   资料中如实是说:        2, 一个页面只允许有一个ScriptManager,并且放在其他ajax控件的前面.       3,ScriptManager掌管着客户端Ajax页的多有脚本,并在页面中注册Ajax类
创建一个ASP.NET AJAX页面，实时显示当前时间，要求页面不会整体刷新。 提示：使用ScriptManager控件、UpdatePanel控件和Timer控件。
最新发布
05-27
好的，我可以为您解答这个问题。 首先，我们需要在页面上添加...这样，我们就完成了使用ScriptManager控件、UpdatePanel控件和Timer控件来实现ASP.NET AJAX页面实时显示当前时间的功能，而且页面不会整体刷新。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值