_XDocument3.NotifyHost(String) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath

Ensamblado:

Microsoft.Office.Interop.InfoPath.dll

Proporciona un valor personalizado para la aplicación host o la 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

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

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, vea 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 usaría la Host propiedad para recuperar un objeto personalizado para trabajar con el modelo de objetos de la aplicación host en su lugar.

Para obtener información sobre cómo hospedar InfoPath como un control en otra aplicación, 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.