_XDocument3.NotifyHost(String) Método

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Fornece um valor personalizado para o aplicativo de hospedagem ou a página ASPX.

public:
 void NotifyHost(System::String ^ bstrNotification);

public void NotifyHost (string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

Parâmetros

bstrNotification

String

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

Exemplos

O exemplo a seguir mostra como seria o manipulador de eventos no code-behind de uma página ASPX para receber o valor da cadeia de caracteres fornecido pelo método NotifyHost . Neste exemplo, o método NotifyHost estaria fornecendo "ActionA" como o bstrNotification 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

O exemplo a seguir mostra como seria o manipulador de eventos no code-behind de uma página ASPX para receber o valor da cadeia de caracteres fornecido pelo método NotifyHost . Neste exemplo, o método NotifyHost estaria fornecendo "ActionA" como o bstrNotification 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 do 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 como um controle em outro aplicativo, consulte o artigo intitulado "Hospedagem do Ambiente de Edição de Formulários do InfoPath em um Formulário Web Personalizado" no Portal do Desenvolvedor do InfoPath