RegisterForEvent 方法
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
启用 Web 部件为系统或自定义事件注册。
RegisterForEvent (NamespaceURN, EventName, Function, UniqueQualifier)
参数
参数 |
说明 |
---|---|
NamespaceURN |
一个为用户定义的命名空间命名的 string,该命名空间提供用于解析事件名称、对象名等的上下文。 |
EventName |
一个 string,包含要为其注册 Web 部件的事件的名称。 |
Function |
对事件发生时要调用的函数的引用。可以使用 RaiseEvent 方法的 EventObject 参数来将值传递给此函数。 |
UniqueQualifier |
可选。部件的唯一限定符。 |
备注
将 RegisterForEvent 方法和 RaiseEvent 方法一起使用可创建 Web 部件之间的协调响应。在 Microsoft Visual Basic Scripting Edition (VBScript) 中使用此方法时,必须使用 GetRef 函数传递该函数。这将确保两种方法使用同一指针。(有关 GetRef 函数的信息,请参阅 MSDN 库中的 VBScript 文档。)
在必须保留调用 Web 部件的标识的情况下,UniqueQualifier 参数会非常有用。典型的示例是当为同一事件注册多个部件并希望为每个部件触发事件而不是仅为所有部件触发一次事件时。如果为同一事件注册所有三个部件并且未指定任何限定符,或如果为每个部件指定同一限定符,则仅为所有三个部件触发一次事件。如果为每个部件提供一个唯一的限定符,则事件将触发三次。
可以将 Web 部件注册为接收浏览器中触发的标准系统事件的通知。这些事件的 NamespaceURN 为"urn:schemas-microsoft-com:dhtml"。有关受支持的标准系统事件的列表,请参阅 Web 部件页服务组件 (WPSC) 对象模型。
示例 1:Microsoft Visual Basic Scripting Edition
代码
WPSC.RegisterForEvent "urn:testchange","onUpdate", GetRef("CheckWebPart
示例 2:Microsoft JScript
代码
WPSC.RegisterForEvent("urn:testchange","onUpdate", CheckWebPart);
要求
适用于:WPSC 对象