_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.

Примеры

В следующем примере показано, как должен выглядеть обработчик события в фоновом коде страницы ASPX, чтобы получить значение строки, предоставленное методом NotifyHost. В этом примере метод 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

В следующем примере показано, как должен выглядеть обработчик события в фоновом коде страницы ASPX, чтобы получить значение строки, предоставленное методом NotifyHost. В этом примере метод 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 на странице ASPX, работающей из Microsoft SharePoint Server 2010 с InfoPath Forms Services. Значение, указанное notification для параметра, — это строка, которую код программной части страницы ASPX узла может использовать для выполнения настраиваемого действия.

Сведения о размещении шаблона формы InfoPath на странице ASPX см. в статье "Размещение среды редактирования форм InfoPath в пользовательской веб-форме" на портале разработчика InfoPath.

Метод NotifyHost также можно использовать, когда приложение InfoPath размещается в качестве элемента управления в другом приложении, хотя в этом сценарии свойство обычно используется Host для получения пользовательского объекта для работы с объектной моделью ведущего приложения.

Сведения о размещении InfoPath в качестве элемента управления в другом приложении см. в статье "Размещение среды редактирования форм InfoPath в пользовательской веб-форме" на портале разработчика InfoPath.