del método XmlForm.NotifyHost
Proporciona un valor personalizado a la aplicación de hospedaje o la página ASPX.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Sub NotifyHost ( _
notification As String _
)
'Uso
Dim instance As XmlForm
Dim notification As String
instance.NotifyHost(notification)
public abstract void NotifyHost(
string notification
)
Parámetros
notification
Tipo: System.StringValor personalizado que usará el código de la aplicación de hospedaje o la página ASPX.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | El parámetro pasado a este método es una referencia null (Nothing en Visual Basic). |
ArgumentException | El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido. |
Comentarios
El método NotifyHost está diseñado para escenarios en los que una plantilla de formulario de InfoPath se hospeda 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 subyacente 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 acerca del hospedaje del entorno de edición de InfoPath Form en un formulario web personalizado, en el portal de desarrolladores 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 sobre cómo hospedar InfoPath en otra aplicación, vea el artículo acerca del hospedaje del entorno de edición de InfoPath 2007 en una aplicación de Windows Forms personalizada, en el portal de desarrolladores de InfoPath en MSDN.
Ú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.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Ejemplos
En el siguiente ejemplo de código, se muestra el aspecto que debe tener el controlador de eventos del código subyacente de una página ASPX para recibir el valor de cadena proporcionado por el método NotifyHost. En este ejemplo, el método NotifyHost proporcionaría "ActionA" como el parámetro notification 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