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

Параметр, передаваемый этому методу, является пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу передан недопустимый параметр. Например, неправильный тип или формат.

Примеры

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

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

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

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

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.