鸿蒙开发接口Ability框架:【(AbilityDelegator)】

2024-05-13 19:12

本文主要是介绍鸿蒙开发接口Ability框架:【(AbilityDelegator)】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

AbilityDelegator

AbilityDelegator提供添加用于监视指定能力的生命周期状态更改的AbilityMonitor对象的能力,包括对AbilityMonitor实例的添加、删除、等待ability到达OnCreate生命周期、设置等待时间等、获取指定ability的生命周期状态、获取当前应用顶部ability、启动指定ability等。

说明:

本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

使用说明

开发前请熟悉鸿蒙开发指导文档:gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

通过AbilityDelegatorRegistry中getAbilityDelegator方法获取。

import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'var abilityDelegator;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();

AbilityDelegator

addAbilityMonitor9+

addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<void>): void

添加AbilityMonitor实例(callback形式)

系统能力:SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明说明
monitorAbilityMonitorAbilityMonitor实例
callbackAsyncCallback<void>表示指定的回调方法

示例:

var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (err : any) => {console.info("addAbilityMonitor callback");
});

addAbilityMonitor9+

addAbilityMonitor(monitor: AbilityMonitor): Promise<void>

添加AbilityMonitor实例(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
monitorAbilityMonitorAbilityMonitor实例

返回值:

类型说明
Promise<void>以Promise形式返回。

示例:

var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor).then(() => {console.info("addAbilityMonitor promise");
});

removeAbilityMonitor9+

removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<void>): void

删除已经添加的AbilityMonitor实例(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
monitorAbilityMonitorAbilityMonitor实例
callbackAsyncCallback<void>表示指定的回调方法

示例:

var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor, (err : any) => {console.info("removeAbilityMonitor callback");
});

removeAbilityMonitor9+

removeAbilityMonitor(monitor: AbilityMonitor): Promise<void>

删除已经添加的AbilityMonitor实例(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

名称类型必填说明
monitorAbilityMonitorAbilityMonitor实例

返回值:

类型说明
Promise<void>以Promise形式返回。
  • 示例
var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.removeAbilityMonitor(monitor).then(() => {console.info("removeAbilityMonitor promise");
});

waitAbilityMonitor9+

waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback<Ability>): void

等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期,并返回ability实例(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
monitorAbilityMonitorAbilityMonitor实例
callbackAsyncCallback<Ability>表示指定的回调方法

示例:

var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, (err : any, data : any) => {console.info("waitAbilityMonitor callback");
});

waitAbilityMonitor9+

waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback<Ability>): void

设置等待时间,等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期,并返回ability实例(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
monitorAbilityMonitorAbilityMonitor实例
timeoutnumber最大等待时间,单位毫秒(ms)
callbackAsyncCallback<Ability>表示指定的回调方法

示例:

var abilityDelegator;
var timeout = 100;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor, timeout, (err : any, data : any) => {console.info("waitAbilityMonitor callback");
});

waitAbilityMonitor9+

waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise<Ability>

设置等待时间,等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期,并返回ability实例(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
monitorAbilityMonitorAbilityMonitor实例
timeoutnumber最大等待时间,单位毫秒(ms)

返回值:

类型说明
Promise<Ability>以Promise形式返回Ability。

示例:

var abilityDelegator;function onAbilityCreateCallback(data) {console.info("onAbilityCreateCallback");
}var monitor = {abilityName: "abilityname",onAbilityCreate: onAbilityCreateCallback
}abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => {console.info("waitAbilityMonitor promise");
});

getAppContext9+

getAppContext(): Context

获取应用Context

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

返回值:

类型说明
Context应用Context。

示例:

var abilityDelegator;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
var context = abilityDelegator.getAppContext();

getAbilityState9+

getAbilityState(ability: Ability): number

获取指定ability的生命周期状态

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
abilityAbility指定Ability对象

返回值:

类型说明
number指定ability的生命周期状态。状态枚举值使用AbilityLifecycleState。

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;var state = abilityDelegator.getAbilityState(ability);console.info("getAbilityState" + state);
});

getCurrentTopAbility9+

getCurrentTopAbility(callback: AsyncCallback<Ability>): void

获取当前应用顶部ability(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
callbackAsyncCallback<Ability>表示指定的回调方法

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;
});

getCurrentTopAbility9+

getCurrentTopAbility(): Promise<Ability>

获取当前应用顶部ability(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

返回值:

类型说明
Promise<Ability>以Promise形式返回当前应用顶部ability。

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility().then((data : any) => {console.info("getCurrentTopAbility promise");ability = data;
});

startAbility9+

startAbility(want: Want, callback: AsyncCallback<void>): void

启动指定ability(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
wantWant启动Ability参数
callbackAsyncCallback<void>表示指定的回调方法

示例:

var abilityDelegator;
var want = {bundleName: "bundleName",abilityName: "abilityName"
};abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want, (err : any, data : any) => {console.info("startAbility callback");
});

startAbility9+

startAbility(want: Want): Promise<void>

启动指定ability(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
wantWant启动Ability参数

返回值:

类型说明
Promise<void>以Promise形式返回。

示例:

var abilityDelegator;
var want = {bundleName: "bundleName",abilityName: "abilityName"
};abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.startAbility(want).then((data: any) => {console.info("startAbility promise");
});

doAbilityForeground9+

doAbilityForeground(ability: Ability, callback: AsyncCallback<boolean>): void

调度指定ability生命周期状态到Foreground状态(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
abilityAbility指定Ability对象
callbackAsyncCallback<boolean>表示指定的回调方法 - true:成功 - false:失败

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;abilityDelegator.doAbilityForeground(ability, (err : any, data : any) => {console.info("doAbilityForeground callback");});
});

doAbilityForeground9+

doAbilityForeground(ability: Ability): Promise<boolean>

调度指定ability生命周期状态到Foreground状态(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
abilityAbility指定Ability对象

返回值:

类型说明
Promise<boolean>以Promise形式返回执行结果。 - true:成功 - false:失败

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;abilityDelegator.doAbilityForeground(ability).then((data : any) => {console.info("doAbilityForeground promise");});
});

doAbilityBackground9+

doAbilityBackground(ability: Ability, callback: AsyncCallback<boolean>): void

调度指定ability生命周期状态到Background状态(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
abilityAbility指定Ability对象
callbackAsyncCallback<boolean>表示指定的回调方法 - true:成功 - false:失败

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;abilityDelegator.doAbilityBackground(ability, (err : any, data : any) => {console.info("doAbilityBackground callback");});
});

doAbilityBackground9+

doAbilityBackground(ability: Ability): Promise<boolean>

调度指定ability生命周期状态到Background状态(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
abilityAbility指定Ability对象

返回值:

类型说明
Promise<boolean>以Promise形式返回执行结果。 - true:成功 - false:失败

示例:

var abilityDelegator;
var ability;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.getCurrentTopAbility((err : any, data : any) => {console.info("getCurrentTopAbility callback");ability = data;abilityDelegator.doAbilityBackground(ability).then((data : any) => {console.info("doAbilityBackground promise");});
});

print

print(msg: string, callback: AsyncCallback<void>): void

打印日志信息到单元测试终端控制台(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
msgstring日志字符串
callbackAsyncCallback<void>表示指定的回调方法

示例:

var abilityDelegator;
var msg = "msg";abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg, (err : any) => {console.info("print callback");
});

print

print(msg: string): Promise<void>

打印日志信息到单元测试终端控制台(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
msgstring日志字符串

返回值:

类型说明
Promise<void>以Promise形式返回。

示例:

var abilityDelegator;
var msg = "msg";abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.print(msg).then(() => {console.info("print promise");
});

executeShellCommand

executeShellCommand(cmd: string, callback: AsyncCallback<ShellCmdResult>): void

执行指定的shell命令(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
cmdstringshell命令字符串
callbackAsyncCallback<ShellCmdResult>表示指定的回调方法

示例:

var abilityDelegator;
var cmd = "cmd";abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, (err : any, data : any) => {console.info("executeShellCommand callback");
});

executeShellCommand

executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback<ShellCmdResult>): void

指定超时时间,并执行指定的shell命令(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
cmdstringshell命令字符串
timeoutSecsnumber设定命令超时时间,单位秒(s)
callbackAsyncCallback<ShellCmdResult>表示指定的回调方法

示例:

var abilityDelegator;
var cmd = "cmd";
var timeout = 100;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout, (err : any, data : any) => {console.info("executeShellCommand callback");
});

executeShellCommand

executeShellCommand(cmd: string, timeoutSecs?: number): Promise<ShellCmdResult>

指定超时时间,并执行指定的shell命令(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
cmdstringshell命令字符串
timeoutSecsnumber设定命令超时时间,单位秒(s)

返回值:

类型说明
Promise<ShellCmdResult>以Promise形式返回Shell命令执行结果ShellCmdResult对象。

示例:

var abilityDelegator;
var cmd = "cmd";
var timeout = 100;abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.executeShellCommand(cmd, timeout).then((data : any) => {console.info("executeShellCommand promise");
});

finishTest9+

finishTest(msg: string, code: number, callback: AsyncCallback<void>): void

结束测试并打印日志信息到单元测试终端控制台(callback形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
msgstring日志字符串
codenumber日志码
callbackAsyncCallback<void>表示指定的回调方法

示例:

var abilityDelegator;
var msg = "msg";abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0, (err : any) => {console.info("finishTest callback");
});

finishTest9+

finishTest(msg: string, code: number): Promise<void>

结束测试并打印日志信息到单元测试终端控制台(promise形式)

系统能力:  SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名类型必填说明
msgstring日志字符串
codenumber日志码

返回值:

搜狗高速浏览器截图20240326151450.png

示例:

var abilityDelegator;
var msg = "msg";abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.finishTest(msg, 0).then(() => {console.info("finishTest promise");
});

最后呢,很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。由两位前阿里高级研发工程师联合打造《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点

如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

高清完整版请点击→《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说,我们直接看详细资料鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

图片

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

获取这份鸿蒙星河版学习资料,请点击→《鸿蒙NEXT星河版开发学习文档》

OpenHarmony北向、南向开发环境搭建

图片

《鸿蒙开发基础》

  1. ArkTS语言

  2. 安装DevEco Studio

  3. 运用你的第一个ArkTS应用

  4. ArkUI声明式UI开发

  5. .……

图片

《鸿蒙开发进阶》

  1. Stage模型入门

  2. 网络管理

  3. 数据管理

  4. 电话服务

  5. 分布式应用开发

  6. 通知与窗口管理

  7. 多媒体技术

  8. 安全技能

  9. 任务管理

  10. WebGL

  11. 国际化开发

  12. 应用测试

  13. DFX面向未来设计

  14. 鸿蒙系统移植和裁剪定制

  15. ……

图片

《鸿蒙开发实战》

  1. ArkTS实践

  2. UIAbility应用

  3. 网络案例

  4. ……

图片

 获取这份鸿蒙星河版学习资料,请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程,从而开设鸿蒙课程;企业纷纷跟进启动了鸿蒙研发

并且鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,未来将会支持 50 万款的应用那么这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行!

这篇关于鸿蒙开发接口Ability框架:【(AbilityDelegator)】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/986578

相关文章

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll

MyBatis-Flex BaseMapper的接口基本用法小结

《MyBatis-FlexBaseMapper的接口基本用法小结》本文主要介绍了MyBatis-FlexBaseMapper的接口基本用法小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具... 目录MyBATis-Flex简单介绍特性基础方法INSERT① insert② insertSelec

Spring排序机制之接口与注解的使用方法

《Spring排序机制之接口与注解的使用方法》本文介绍了Spring中多种排序机制,包括Ordered接口、PriorityOrdered接口、@Order注解和@Priority注解,提供了详细示例... 目录一、Spring 排序的需求场景二、Spring 中的排序机制1、Ordered 接口2、Pri

Idea实现接口的方法上无法添加@Override注解的解决方案

《Idea实现接口的方法上无法添加@Override注解的解决方案》文章介绍了在IDEA中实现接口方法时无法添加@Override注解的问题及其解决方法,主要步骤包括更改项目结构中的Languagel... 目录Idea实现接China编程口的方法上无法添加@javascriptOverride注解错误原因解决方

修改若依框架Token的过期时间问题

《修改若依框架Token的过期时间问题》本文介绍了如何修改若依框架中Token的过期时间,通过修改`application.yml`文件中的配置来实现,默认单位为分钟,希望此经验对大家有所帮助,也欢迎... 目录修改若依框架Token的过期时间修改Token的过期时间关闭Token的过期时js间总结修改若依

基于Python开发PPTX压缩工具

《基于Python开发PPTX压缩工具》在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,不便于传输和存储,所以本文将使用Python开发一个PPTX压缩工具,需要的可以了解下... 目录引言全部代码环境准备代码结构代码实现运行结果引言在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,

Java function函数式接口的使用方法与实例

《Javafunction函数式接口的使用方法与实例》:本文主要介绍Javafunction函数式接口的使用方法与实例,函数式接口如一支未完成的诗篇,用Lambda表达式作韵脚,将代码的机械美感... 目录引言-当代码遇见诗性一、函数式接口的生物学解构1.1 函数式接口的基因密码1.2 六大核心接口的形态学

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》:本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.

详解Java如何向http/https接口发出请求

《详解Java如何向http/https接口发出请求》这篇文章主要为大家详细介绍了Java如何实现向http/https接口发出请求,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 用Java发送web请求所用到的包都在java.net下,在具体使用时可以用如下代码,你可以把它封装成一