_XDocument3.NotifyHost(String) 方法

定义

命名空间:

Microsoft.Office.Interop.InfoPath

程序集:

Microsoft.Office.Interop.InfoPath.dll

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

public:
 void NotifyHost(System::String ^ bstrNotification);

public void NotifyHost (string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

参数

bstrNotification

String

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

示例

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

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 方法提供的字符串值，应如何编写 ASPX 页代码隐藏技术的事件处理程序。 在此示例中， NotifyHost 方法将提供“ActionA”作为 bstrNotification 参数，事件处理程序将在收到值时执行条件操作。

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 运行且具有InfoPath Forms Services的 ASPX 页上。 为 notification 参数提供的值是一个字符串，主机 ASPX 页的代码隐藏可以使用该字符串来执行自定义操作。

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

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

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