Clase SubmitToHostConnection
Representa una conexión para el envío de datos a un entorno de hospedaje.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SubmitToHostConnection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class SubmitToHostConnection _
Inherits DataConnection
'Uso
Dim instance As SubmitToHostConnection
public abstract class SubmitToHostConnection : DataConnection
Comentarios
Este tipo de conexión se usa en una plantilla de formulario que se abre en una aplicación que hospeda del entorno como un control de edición de formularios de InfoPath. Para obtener información acerca de cómo alojar InfoPath como un control, incluida la información sobre cómo crear un método para controlar el evento para el envío de un formulario en el código de la aplicación host, vea el artículo titulado hospeda el entorno de edición de formularios de InfoPath en una aplicación de formularios de Windows personalizada en MSDN.
Para crear una conexión de datos para enviar datos a un entorno de hospedaje al que se puede hacer referencia desde la lógica empresarial de una plantilla de formulario, use el comando Conexiones de datos de la pestaña Datos de la cinta. Para obtener información sobre cómo crear un controlador de eventos que se ejecute cuando se provoque el evento Submit, vea Cómo agregar un controlador de eventos.
Ejemplos
En el siguiente ejemplo se muestra un patrón para escribir código que realizará acciones personalizadas en la lógica empresarial de una plantilla de formulario antes de enviar el formulario.
public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
// Get the data connection defined in the form template from the
// DataConnections collection and cast to the SubmitToHostConnection
// type.
SubmitToHostConnection submitConnection =
(SubmitToHostConnection)(DataConnections["MyHostConnection"]);
// Write code here to do custom actions that are not
// supported by rules or other declarative settings.
// Execute the submit operation against the connection.
submitConnection.Execute();
}
Public Sub FormEvents_Submit(ByVal sender As Object, _
ByVal e As SubmitEventArg)
' Get the data connection defined in the form template from the
' DataConnections collection and cast to the SubmitToHostConnection
' type.
Dim submitConnection As SubmitToHostConnection = _
DirectCast(DataConnections("MyHostConnection"), _
SubmitToHostConnection)
' Write code here to do custom actions that are not
' supported by rules or other declarative settings.
' Execute the submit operation against the connection.
submitConnection.Execute()
End Sub
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.