XmlForm.NotifyHost(String) 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

为宿主应用程序或 ASPX 页提供自定义值。

public:
 abstract void NotifyHost(System::String ^ notification);

public abstract void NotifyHost (string notification);

abstract member NotifyHost : string -> unit

Public MustOverride Sub NotifyHost (notification As String)

参数

notification

String

将由主机应用程序或 ASPX 页中的代码使用的自定义值。

例外

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

以下代码示例演示为了接收由 NotifyHost 方法提供的字符串值，应如何编写 ASPX 页代码隐藏技术中的事件处理程序。 在此示例中， NotifyHost 方法将提供“ActionA”作为 notification 参数，事件处理程序将在收到值时执行条件操作。

private void XmlFormView1_NotifyHost(Object sender, 
   NotifyHostEventArgs e)
{
   if (e.Notification == "ActionA")
   {
      // Code to perform if 'ActionA' is received.
   }

   else 
   {
      // Code to perform an alternative action.
   }
}

Private Sub XmlFormView1_NotifyHost(sender As Object, _
   e As NotifyHostEventArgs)
   If (e.Notification = "ActionA") Then
      ' Code to perform if 'ActionA' is received.
   Else 
      ' Code to perform an alternative action.
   End If
End Sub

注解

NotifyHost 方法适用于以下场景：InfoPath 表单模板托管在 Microsoft.Office.InfoPath.Server.Controls.XmlFormView 控件中，该控件在 Microsoft SharePoint Server 2010 上运行的 ASPX 页面上，InfoPath Forms Services。 为 notification 参数提供的值是一个字符串，主机 ASPX 页的代码隐藏可以使用该字符串来执行自定义操作。

有关在 ASPX 页中托管 InfoPath 表单模板的信息，请参阅 InfoPath 开发人员门户上标题为“在自定义 Web 窗体中托管 InfoPath 表单编辑环境”的文章

当 InfoPath 应用程序本身作为控件托管在另一个应用程序中时，也可以使用 NotifyHost 方法，尽管在这种情况下，通常使用 Host 属性来检索自定义对象以使用主机应用程序的对象模型。

有关在另一个应用程序中托管 InfoPath 的信息，请参阅 InfoPath 开发人员门户上标题为“在自定义 Windows 窗体应用程序中托管 InfoPath 编辑环境”的文章

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。