新瓶旧酒ASP.NET AJAX(10) - 客户端脚本编程（Sys.Services命名空间下的类）

关注

原创最新推荐文章于 2026-03-25 12:37:29 发布 509 阅读 AI 写同款· GEO 优化 ›

ASP.NET请求生命周期三张图：从HTTP.SYS到Page事件全解析 ASP.NET请求生命周期是理解Web应用执行时序与状态流转的基础概念，其核心原理在于IIS与ASP.NET集成管线的分层协作机制——HTTP.SYS负责内核级连接调度，IIS工作进程完成身份认证与URL路由，CLR中的HttpRuntime启动事件驱动的HttpApplication管线，最终由Page对象承载Web Forms的控件树生命周期。这一机制决定了Session初始化时机、ViewState序列化流程、异步异常捕获边界等关键技术价值，广泛应用于性能调优、500/404故障定位、内存泄漏排查及遗阅读详情

[索引页]
[源码下载]

新瓶旧酒ASP.NET AJAX(10) - 客户端脚本编程（Sys.Services命名空间下的类）

作者： webabcd

介绍
ASP.NET AJAX的Sys.Services.AuthenticationService类、Sys.Services.ProfileService类、Sys.Services.ProfileGroup类完美地和ASP.NET 2.0的Membership和Profile进行了集成

关键
1、Sys.Services.AuthenticationService类的login()方法
    Sys.Services.AuthenticationService.login(userName, password, isPersistent, customInfo, redirectUrl, loginCompletedCallback, failedCallback, userContext);
    ·userName - 用户名
    ·password - 密码
    ·isPersistent - 是否跨浏览器保存认证信息（持久保留）
    ·customInfo - 保留字段，可能在将来使用
    ·redirectUrl - 登录成功后重定向到的URL
    ·loginCompletedCallback - 登录成功后的回调函数
    ·failedCallback - 登录失败后的回调函数
    ·userContext - 用户上下文
    WebService中与其对应的方法 - public bool Login()

2、登录成功后的回调函数
    function LoginComplete(bool validCredentials, userContext, methodName)
    ·validCredentials - 是否成功通过了验证
    ·userContext - 用户上下文
    ·methodName - 调用的方法名

3、Sys.Services.AuthenticationService类的logout()方法
    Sys.Services.AuthenticationService.logout(redirectUrl, logoutCompletedCallback, failedCallback, userContext);
    ·redirectUrl - 注销成功后重定向到的URL
    ·logoutCompletedCallback - 注销成功后的回调函数
    ·failedCallback - 注销失败后的回调函数
    ·userContext - 用户上下文
    WebService中与其对应的方法 - public void Logout()

4、注销成功后的回调函数
    function LogoutComplete(result, userContext, methodName)
    ·result - 保留字段，可能在将来使用，始终为null
    ·userContext - 用户上下文
    ·methodName - 调用的方法名

5、Sys.Services.AuthenticationService类的属性
    ·defaultLoginCompletedCallback - 登录成功后的回调函数
    ·defaultLogoutCompletedCallback - 注销成功后的回调函数
    ·defaultFailedCallback - 登录或注销失败后的回调函数
    ·isLoggedIn - 当前用户是否已经登录
    ·path - authentication service路径
    ·timeout - 超时时间

6、Sys.Services.ProfileService类的load()方法
    Sys.Services.ProfileService.load(propertyNames, loadCompletedCallback, failedCallback, userContext);
    ·propertyNames - Profile属性名称数组
    ·loadCompletedCallback - 成功后的回调函数
    ·failedCallback - 失败后的回调函数
    ·userContext - 用户上下文
    WebService中与其对应的方法 - public IDictionary<string, object> GetAllPropertiesForCurrentUser()和public IDictionary<string, object> GetPropertiesForCurrentUser(string[] properties)

7、读取Profile成功后的回调函数
    function onLoadCompleted(numProperties, userContext, methodName)
    ·numProperties - 返回的Profile属性个数
    ·userContext - 用户上下文
    ·methodName - 调用的方法名

8、Sys.Services.ProfileService类的save()方法
    Sys.Services.ProfileService.load(propertyNames, saveCompletedCallback, failedCallback, userContext);
    ·propertyNames - Profile属性名称数组
    ·saveCompletedCallback - 成功后的回调函数
    ·failedCallback - 失败后的回调函数
    ·userContext - 用户上下文
    ·WebService中与其对应的方法 - public int SetPropertiesForCurrentUser(IDictionary<string, object> values)

9、保存Profile成功后的回调函数
    onSaveCompleted(numProperties, userContext, methodName)
    ·numProperties - 保存的Profile属性个数
    ·userContext - 用户上下文
    ·methodName - 调用的方法名

10、Sys.Services.ProfileService类的属性
    ·读取或设置某个Profile的属性要这么写 - Sys.Services.ProfileService.properties.FieldName;
    ·defaultLoadCompletedCallback - 读取Profile成功后的回调函数
    ·defaultSaveCompletedCallback - 保存Profile成功后的回调函数
    ·defaultFailedCallback - 读取或保存Profile失败后的回调函数
    ·path - profile service路径
    ·timeout - 超时时间

11、Sys.Services.ProfileGroup类
    ·定义一个Profile组（同时需要在Web.config中定义）

12、登录或注销失败、读取或保存Profile失败后的回调函数
    function onFailed(error, userContext, methodName)
    ·error - Sys.Net.WebServiceError对象
    ·userContext - 用户上下文
    ·methodName - 调用的方法名

13、如果要自动调用相关服务的话，则需要在web.config中的<configuration />节点下增加类似如下的配置

< webServices >

< authenticationService enabled ="true" requireSSL ="false" />

< profileService enabled ="true"

readAccessProperties ="Age, Salary"

writeAccessProperties ="Age, Salary"

</ webServices >

示例
AuthenticationService.asmx

<% @ WebService Language = " C# " Class = " AuthenticationService " %>

using System;

using System.Web;

using System.Web.Services;

using System.Web.Services.Protocols;

using System.Web.Script.Services;

[WebService(Namespace = " http://tempuri.org/ " )]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[ScriptService]

public class AuthenticationService : System.Web.Services.WebService

{

/// <summary>

/// 登录

/// </summary>

/// <param name="userName">用户名</param>

/// <param name="password">密码</param>

/// <param name="createPersistentCookie">是否跨浏览器保存认证信息（持久保留）</param>

/// <returns></returns>

[WebMethod]

public bool Login(string userName, string password, bool createPersistentCookie)

{

//Place code here.

System.Web.Security.FormsAuthentication.SetAuthCookie(userName, createPersistentCookie);

return true;

}

/// <summary>

/// 注销

/// </summary>

[WebMethod]

public void Logout()

{

//Place code here.

}

ProfileService.asmx

<% @ WebService Language = " C# " Class = " ProfileService " %>

using System;

using System.Web;

using System.Web.Services;

using System.Web.Services.Protocols;

using System.Web.Script.Services;

using System.Collections.Generic;

[WebService(Namespace = " http://tempuri.org/ " )]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[ScriptService]

public class ProfileService : System.Web.Services.WebService

{

/// <summary>

/// 获取用户的全部Profile

/// </summary>

/// <returns></returns>

[WebMethod]

public IDictionary<string, object> GetAllPropertiesForCurrentUser()

{

Dictionary<string, object> dic = new Dictionary<string, object>();

dic.Add("Age", 27);

dic.Add("Salary", 100);

Article article = new Article();

article.Title = "Article Title From Server";

article.PublishTime = DateTime.Now;

dic.Add("Article", article);

return dic;

}

/// <summary>

/// 获取用户的指定的Profile

/// </summary>

/// <param name="properties">属性名称数组</param>

/// <returns></returns>

[WebMethod]

public IDictionary<string, object> GetPropertiesForCurrentUser(string[] properties)

{

//Place code here.

return null;

}

/// <summary>

/// 保存用户的Profile

/// </summary>

/// <param name="values">用户的Profile的字典数据</param>

/// <returns></returns>

[WebMethod]

public int SetPropertiesForCurrentUser(IDictionary<string, object> values)

{

//Place code here.

return values.Count;

}

/// <summary>

/// Article实体类

/// </summary>

/// <remarks>

/// 示例而已，实际项目中要继承自System.Web.Profile.ProfileBase

/// </remarks>

public class Article

{

private string _title;

/// <summary>

/// 文章标题

/// </summary>

public string Title

{

get { return _title; }

set { _title = value; }

}

private DateTime _publishTime;

/// <summary>

/// 文章发布日期

/// </summary>

public DateTime PublishTime

{

get { return _publishTime; }

set { _publishTime = value; }

}

Sample.aspx

<% @ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="Sample.aspx.cs"

Inherits="ClientScripting_SysServices_Sample" Title="Sys.Services命名空间下的类" %>

< asp:Content ID ="Content1" ContentPlaceHolderID ="ContentPlaceHolder1" runat ="Server" >

< div >

帐号： < input type ="text" id ="txtUserId" /></ div >

< div >

密码： < input type ="password" id ="txtPassword" /></ div >

< div >

  </ div >

< div >

< input type ="button" id ="btnLogin" value ="登录" onclick ="btnLogin_click()" />

< input type ="button" id ="btnLogout" value ="注销" onclick ="btnLogout_click()" /></ div >

< div >

  </ div >

< div >

年龄： < input type ="text" id ="txtAge" /></ div >

< div >

薪水： < input type ="text" id ="txtSalary" /></ div >

< div >

< input type ="button" id ="btnSave" value ="保存Profile" onclick ="btnSave_click()" />

< input type ="button" id ="btnLoad" value ="读取Profile" onclick ="btnLoad_click()" />

</ div >

< div >

  </ div >

< div id ="result" />

< script type ="text/javascript" >

var userId;

var password;

var login;

var logout;

var age;

var salary

function pageLoad()

{

userId = $get("txtUserId");

password = $get("txtPassword");

logout = $get("btnLogout");

age = $get("txtAge");

salary = $get("txtSalary");

// path - authentication service路径

$get("result").innerHTML = "AuthenticationService path：" + Sys.Services.AuthenticationService.get_path() + "<br />";

// timeout - 超时时间

$get("result").innerHTML += "AuthenticationService timeout：" + Sys.Services.AuthenticationService.get_timeout() + "<br />";

// path - profile service路径

$get("result").innerHTML += "ProfileService path：" + Sys.Services.ProfileService.get_path() + "<br />";

// timeout - 超时时间

$get("result").innerHTML += "ProfileService timeout：" + Sys.Services.ProfileService.get_timeout() + "<br />";

}

function btnLogin_click()

{

// defaultLoginCompletedCallback - 登录成功后的回调函数

Sys.Services.AuthenticationService.set_defaultLoginCompletedCallback(onLoginCompleted);

// defaultFailedCallback - 登录或注销失败后的回调函数

Sys.Services.AuthenticationService.set_defaultFailedCallback(onFailed);

Sys.Services.AuthenticationService.login

(

userId.value, // 用户名

password.value, // 密码

false, // 是否跨浏览器保存认证信息（持久保留）

null, // 保留字段，可能在将来使用

null, // 登录成功后重定向到的URL

null, // 登录成功后的回调函数

null, // 登录失败后的回调函数

"用户上下文" // 用户上下文

);

}

function btnLogout_click()

{

// defaultLogoutCompletedCallback - 注销成功后的回调函数

Sys.Services.AuthenticationService.set_defaultLogoutCompletedCallback(onLogoutCompleted);

// defaultFailedCallback - 登录或注销失败后的回调函数

Sys.Services.AuthenticationService.set_defaultFailedCallback(onFailed);

Sys.Services.AuthenticationService.logout

(

null, // 注销成功后重定向到的URL

null, // 注销成功后的回调函数

null, // 注销失败后的回调函数

null // 用户上下文

);

}

function onLoginCompleted(validCredentials, userContext, methodName)

{

password.value = "";

// validCredentials - 是否成功通过了验证

// userContext - 用户上下文

// methodName - 调用的方法名

if (validCredentials)

{

userId.value = "";

$get("result").innerHTML = "登录成功" + "<br />";

$get("result").innerHTML += "用户上下文：" + userContext + "<br />";

$get("result").innerHTML += "调用的方法名为：" + methodName + "<br />";

}

else

{

$get("result").innerHTML = "登录失败" + "<br />";

}

// isLoggedIn - 当前用户是否已经登录

var status = Sys.Services.AuthenticationService.get_isLoggedIn();

$get("result").innerHTML += "登录状态：" + status + "<br />";

}

function onFailed(error, userContext, methodName)

{

// error - Sys.Net.WebServiceError对象

// userContext - 用户上下文

// methodName - 调用的方法名

$get("result").innerHTML += "错误信息：" + error.get_message() + "<br />";

}

function onLogoutCompleted(result, userContext, methodName)

{

// result - 保留字段，可能在将来使用，始终为null

// userContext - 用户上下文

// methodName - 调用的方法名

alert("成功调用" + methodName) + "<br />";

}

function btnLoad_click()

{

// defaultLoadCompletedCallback - 读取Profile成功后的回调函数

Sys.Services.ProfileService.set_defaultLoadCompletedCallback(onLoadCompleted);

// defaultFailedCallback - 读取或保存Profile失败后的回调函数

Sys.Services.ProfileService.set_defaultFailedCallback(onFailed);

Sys.Services.ProfileService.load

(

null, // Profile属性名称数组

null, // 成功后的回调函数

null, // 失败后的回调函数

null // 用户上下文

);

}

function btnSave_click()

{

// defaultSaveCompletedCallback - 保存Profile成功后的回调函数

Sys.Services.ProfileService.set_defaultSaveCompletedCallback(onSaveCompleted);

// defaultFailedCallback - 读取或保存Profile失败后的回调函数

Sys.Services.ProfileService.set_defaultFailedCallback(onFailed);

Sys.Services.ProfileService.properties.Age = age.value;

Sys.Services.ProfileService.properties.Salary = salary.value;

// 定义一个Profile组（同时需要在Web.config中定义）

Sys.Services.ProfileService.properties.Article = new Sys.Services.ProfileGroup();

Sys.Services.ProfileService.properties.Article.Title = "Article Title";

Sys.Services.ProfileService.properties.Article.PublishTime = new Date();

Sys.Services.ProfileService.save

(

null, // Profile属性名称数组

null, // 成功后的回调函数

null, // 失败后的回调函数

null // 用户上下文

);

}

function onLoadCompleted(numProperties, userContext, methodName)

{

// numProperties - 返回的Profile属性个数

// userContext - 用户上下文

// methodName - 调用的方法名

$get("result").innerHTML = "通过Profile读取的属性的数量为：" + numProperties.toString() + "<br />";

$get("result").innerHTML += "Age：" + Sys.Services.ProfileService.properties.Age + "<br />";

$get("result").innerHTML += "Article Title：" + Sys.Services.ProfileService.properties.Article.Title + "<br />";

$get("result").innerHTML += "Article PublishTime：" + Sys.Services.ProfileService.properties.Article.PublishTime.format("yyyy-MM-dd") + "<br />";

}

function onSaveCompleted(numProperties, userContext, methodName)

{

// numProperties - 保存的Profile属性个数

// userContext - 用户上下文

// methodName - 调用的方法名

$get("result").innerHTML = "通过Profile保存的属性的数量为：" + numProperties.toString() + "<br />";

}

</ script >

</ asp:Content >

ScriptManager的设置

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

< AuthenticationService Path ="~/ClientScripting/SysServices/AuthenticationService.asmx" />

< ProfileService Path ="~/ClientScripting/SysServices/ProfileService.asmx" />

</ asp:ScriptManager >

Web.config中的相关设置（在<system.web />节点下）

< profile enabled ="true" >

< properties >

< group name ="Article" >

< add name ="Title" type ="System.String" />

< add name ="PublishTime" type ="System.DateTime" />

</ group >

</ properties >

</ profile >

运行结果
1、页面加载后
AuthenticationService path：/Web/ClientScripting/SysServices/AuthenticationService.asmx
AuthenticationService timeout：0
ProfileService path：ProfileService.asmx
ProfileService timeout：0

2、单击“登录”按钮
登录成功
用户上下文：用户上下文
调用的方法名为：Sys.Services.AuthenticationService.login
登录状态：true

3、单击“注销”按钮
弹出框，信息：成功调用Sys.Services.AuthenticationService.logout

4、单击“保存Profile”按钮
通过Profile保存的属性的数量为：4

5、单击“读取Profile”按钮
通过Profile读取的属性的数量为：3
Age：27
Article Title：Article Title From Server
Article PublishTime：2007-07-12

OK
[源码下载]

收录于