_XDocument4.NotifyHost(String) Método

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

public void NotifyHost(string bstrNotification);

abstract member NotifyHost : string -> unit

Public Sub NotifyHost (bstrNotification As String)

Parámetros

Implementaciones

Ejemplos

En el siguiente ejemplo se muestra el aspecto que debe tener el controlador de eventos del código detrás de una página para recibir el valor de cadena proporcionado por el método NotifyHost. En este ejemplo, el método NotifyHost proporcionaría "ActionA" como bstrNotification parámetro y el controlador de eventos realizaría una acción condicional cuando se reciba el valor.

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

En el siguiente ejemplo se muestra el aspecto que debe tener el controlador de eventos del código detrás de una página para recibir el valor de cadena proporcionado por el método NotifyHost. En este ejemplo, el método NotifyHost proporcionaría "ActionA" como bstrNotification parámetro y el controlador de eventos realizaría una acción condicional cuando se reciba el valor.

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

Comentarios

El método NotifyHost está pensado para su uso en escenarios en los que una plantilla de formulario de InfoPath se hospeda en un control Microsoft.Office.InfoPath.Server.Controls.XmlFormView en una página ASPX que se ejecuta desde Microsoft SharePoint Server 2010 con InfoPath Forms Services. El valor que proporciona para el notification parámetro es una cadena que puede usar el código subyacente de la página ASPX del host para realizar una acción personalizada.

Para obtener información sobre cómo hospedar una plantilla de formulario de InfoPath en una página ASPX, consulte el artículo titulado "Hospedaje del entorno de edición de formularios de InfoPath en un formulario web personalizado" en el Portal para desarrolladores de InfoPath.

El método NotifyHost también se puede usar cuando la propia aplicación InfoPath se hospeda como un control en otra aplicación, aunque en ese escenario normalmente se usa la Host propiedad para recuperar un objeto personalizado para trabajar con el modelo de objetos de la aplicación host.

Para obtener información sobre cómo hospedar InfoPath como un control en otra aplicación, vea el artículo titulado "Hospedaje del entorno de edición de formularios de InfoPath 2007 en un formulario web personalizado" en el Portal para desarrolladores de InfoPath.

Dado que el método NotifyHost es nuevo en Microsoft InfoPath, debe declarar y convertir al _XDocument4 tipo para tener acceso a este método. Para obtener más información, vea Cómo: Usar miembros del modelo de objetos que no son compatibles con InfoPath 2003.

Importante: Solo se puede acceder a este miembro mediante formularios que se ejecutan en el mismo dominio que el formulario abierto actualmente o mediante formularios a los que se han concedido permisos entre dominios.