XmlForm.NotifyHost(String) Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Fornece um valor personalizado para o aplicativo de hospedagem ou a página 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)

Parâmetros

notification

String

Um valor personalizado que será usado pelo código na página de aplicativo de hospedagem ou ASPX.

Exceções

ArgumentNullException

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

ArgumentException

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

Exemplos

O exemplo de código a seguir mostra como o manipulador de eventos no code-behind de uma página ASPX precisaria ser parecido para receber o valor da cadeia de caracteres fornecido pelo método NotifyHost . Neste exemplo, o método NotifyHost estaria fornecendo "ActionA" como o notification parâmetro e o manipulador de eventos executaria uma ação condicional quando o valor for recebido.

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

Comentários

O método NotifyHost destina-se a ser usado em cenários em que um modelo de formulário do InfoPath é hospedado em um controle Microsoft.Office.InfoPath.Server.Controls.XmlFormView em uma página ASPX em execução no Microsoft SharePoint Server 2010 com InfoPath Forms Services. O valor que você fornece para o notification parâmetro é uma cadeia de caracteres que pode ser usada pelo code-behind da página ASPX do host para executar uma ação personalizada.

Para obter informações sobre como hospedar um modelo de formulário infopath em uma página ASPX, confira o artigo intitulado "Hospedagem do Ambiente de Edição de Formulário infopath em um formulário Web personalizado" no Portal do Desenvolvedor do InfoPath

O método NotifyHost também pode ser usado quando o aplicativo InfoPath está hospedado como um controle em outro aplicativo, embora nesse cenário você normalmente usaria a Host propriedade para recuperar um objeto personalizado para trabalhar com o modelo de objeto do aplicativo host.

Para obter informações sobre como hospedar o InfoPath em outro aplicativo, consulte o artigo intitulado "Hospedagem do Ambiente de Edição do InfoPath em um Aplicativo de Formulário personalizado do Windows" no Portal do Desenvolvedor do InfoPath

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.