XmlForm.NotifyHost(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un valor personalizado para la aplicación host o la página ASPX.
public:
abstract void NotifyHost(System::String ^ notification);public abstract void NotifyHost (string notification);abstract member NotifyHost : string -> unitPublic MustOverride Sub NotifyHost (notification As String)Parámetros
- notification
- String
Valor personalizado que usará el código de la aplicación de hospedaje o la página ASPX.
Excepciones
El parámetro pasado a este método es una referencia nula (Nothing en Visual Basic).
El parámetro que se ha pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.
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 notification 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 en 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 en otra aplicación, consulte el artículo titulado "Hospedaje del entorno de edición de InfoPath en una aplicación personalizada de Windows Form" en el Portal para desarrolladores de InfoPath.
Ú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.