SubmitToHostConnection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Representa uma conexão para enviar dados a um ambiente de hospedagem.

public ref class SubmitToHostConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class SubmitToHostConnection : Microsoft.Office.InfoPath.DataConnection

type SubmitToHostConnection = class
    inherit DataConnection

Public MustInherit Class SubmitToHostConnection
Inherits DataConnection

Herança

Object

DataConnection

SubmitToHostConnection

Exemplos

O exemplo a seguir mostra um padrão para escrever código que executará ações personalizadas na lógica de negócios de um modelo de formulário antes do formulário ser enviado.

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

Comentários

Esse tipo de conexão é usado em um modelo de formulário aberto por um aplicativo que está hospedando o ambiente de edição de formulário infopath como um controle. Para obter informações sobre como hospedar o InfoPath como um controle, incluindo informações sobre como criar um método para lidar com o evento para enviar um formulário no código do aplicativo host, consulte o artigo intitulado Hospedagem do Ambiente de Edição de Formulário infopath em um aplicativo de formulário personalizado do Windows

Para criar uma conexão de dados para enviar dados a um ambiente de hospedagem que pode ser referenciado da lógica de negócios em um modelo de formulário, use o comando Data Connections na guia Dados da faixa de opções. Para obter informações sobre como criar um manipulador de eventos que será executado quando o Submit evento for gerado, consulte Como adicionar um manipulador de eventos.

Construtores

SubmitToHostConnection()

Representa uma conexão para enviar dados a um ambiente de hospedagem.

Propriedades

Name	Obtém o nome da conexão de dados. (Herdado de DataConnection)

Métodos

Execute()

Dependendo da classe ConnectionTypeConnection da qual é chamada, executa uma operação de envio ou consulta na conexão de dados usando os valores definidos declarativamente para os dados enviados, parâmetros de consulta ou dados a serem recuperados. (Herdado de DataConnection)