del método _XDocument3.NotifyHost

Proporciona un valor personalizado para la aplicación de hospedaje o la página ASPX.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
Sub NotifyHost ( _
    bstrNotification As String _
)
'Uso
Dim instance As _XDocument3
Dim bstrNotification As String

instance.NotifyHost(bstrNotification)

void NotifyHost(
    string bstrNotification
)

Parámetros

• bstrNotification
  Tipo: System.String

  Valor personalizado que será utilizado por el código de la aplicación de hospedaje o la página ASPX.

Comentarios

El método NotifyHost se debe usar en casos en que una plantilla de formulario de InfoPath se hospede en un control Microsoft.Office.InfoPath.Server.Controls.XmlFormView de una página ASPX que se ejecuta desde Microsoft SharePoint Server 2010 con InfoPath Forms Services. El valor que proporcione para el parámetro notification debe ser una cadena que el código que está detrás de la página ASPX host pueda usar para realizar una acción personalizada.

Para obtener información acerca de cómo hospedar una plantilla de formulario de InfoPath en una página ASPX, vea el artículo titulado "Hosting the InfoPath Form Editing Environment in a Custom Web Form" en el Portal de programadores de InfoPath en MSDN.

El método NotifyHost también se puede usar cuando la propia aplicación InfoPath está hospedada como control en otra aplicación, aunque en ese caso lo normal sería usar la propiedad Host para recuperar un objeto personalizado para trabajar con el modelo de objetos de la aplicación de hospedaje.

Para obtener información acerca de cómo hospedar InfoPath como un control en otra aplicación, vea el artículo titulado "Hosting the InfoPath 2007 Form Editing Environment in a Custom Web Form" en Portal de programadores de InfoPath en MSDN.

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

Importante

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

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 parámetro bstrNotification y el controlador de eventos llevaría a cabo una acción condicional al recibir 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

Vea también

Referencia

interfaz _XDocument3

Miembros _XDocument3

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust