Метод _XDocument3.NotifyHost

Статья
04/27/2010

Передает пользовательское значение внешнему приложению или странице ASPX.

Пространство имен: Microsoft.Office.Interop.InfoPath
Сборка: Microsoft.Office.Interop.InfoPath (в microsoft.office.interop.infopath.dll)

Синтаксис

'Декларация
<DispIdAttribute(58)> _
Sub NotifyHost ( _
    <InAttribute> bstrNotification As String _
)
'Применение
Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

[DispIdAttribute(58)] 
void NotifyHost (
    [InAttribute] string bstrNotification
)

Параметры

bstrNotification
Пользовательское значение, которое будет использоваться кодом внешнего приложения или страницей ASPX.

Заметки

Метод NotifyHost предназначен для использования в сценариях, в которых шаблон формы InfoPath размещается в элементе управления Microsoft.Office.InfoPath.Server.Controls.XmlFormView на странице ASPX на основе Microsoft Office Forms Server 2007 или в Microsoft Office SharePoint Server 2007 с Служба InfoPath Forms Services. Значение параметра notification представляет собой строку, которая может использоваться кодом внешней страницы ASPX для выполнения пользовательского действия.

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

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

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

Пример

В следующем примере иллюстрируется обработчик событий в коде, обслуживающем ASPX-страницу, который получает строковое значение от метода NotifyHost. В этом примере метод NotifyHost предоставляет в качестве параметра bstrNotification строку "ActionA", а обработчик событий при получении этого значения выполняет некоторое условное действие.

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

См. также

Ссылка

Интерфейс _XDocument3
Члены _XDocument3
Пространство имен Microsoft.Office.Interop.InfoPath

Поделиться через