Метод XmlForm.NotifyHost

Статья
04/27/2010

Предоставляет пользовательское значение для приложения внешнего размещения или страницы ASPX.

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

Синтаксис

'Декларация
Public MustOverride Sub NotifyHost ( _
    notification As String _
)
'Применение
Dim instance As XmlForm
Dim notification As String

instance.NotifyHost(notification)

public abstract void NotifyHost (
    string notification
)

Параметры

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

Исключения

Тип исключения	Условие
ArgumentNullException	Этому методу передан параметр .
ArgumentException	Этому методу передан недопустимый параметр . Например, неправильный тип или формат.

Заметки

Метод 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 см. в статье "Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form" в разделе InfoPath Developer Portal в MSDN (на английском языке).

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

Дополнительные сведения о размещении InfoPath в другом приложении см. в статье "Hosting the InfoPath 2007 Editing Environment in a Custom Windows Form Application" в разделе InfoPath Developer Portal в MSDN (на английском языке).

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

Доступ к этому типу или члену имеется из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007 или в веб-обозревателе.

Пример

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

См. также

Ссылка

Класс XmlForm
Члены XmlForm
Пространство имен Microsoft.Office.InfoPath

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