Share via


SubmitToHostAdapterObject Schnittstelle

Definition

Stellt eine Verbindung zum Senden von Daten an eine Hostumgebung dar.

public interface class SubmitToHostAdapterObject : Microsoft::Office::Interop::InfoPath::SubmitToHostAdapter
[System.Runtime.InteropServices.Guid("096CD739-0786-11D1-95FA-0080C78EE3BB")]
public interface SubmitToHostAdapterObject : Microsoft.Office.Interop.InfoPath.SubmitToHostAdapter
type SubmitToHostAdapterObject = interface
    interface SubmitToHostAdapter
Public Interface SubmitToHostAdapterObject
Implements SubmitToHostAdapter
Abgeleitet
Attribute
Implementiert

Beispiele

Im folgenden Beispiel ist ein Muster zum Schreiben von Code dargestellt, mit dem benutzerdefinierte Aktionen in der Geschäftslogik einer Formularvorlage ausgeführt werden, bevor das Formular gesendet wird.

[InfoPathEventHandler(EventType = InfoPathEventType.OnSubmitRequest]
public void FormEvents_OnSubmitRequest(DocReturnEvent e)
{
   // Get the data adapter defined in the form template from the 
   // DataAdapters collection and cast to the SubmitToHostAdapter
   // type.
   SubmitToHostAdapter submitAdapter = 
      (SubmitToHostAdapter)(DataAdapters["MyHostAdapter"]);

   // Write code here to do custom actions that are not 
   // supported by rules or other declarative settings.  

   // Execute the submit operation against the adapter.
   submitAdapter.Submit();
<InfoPathEventHandler(EventType := InfoPathEventType.OnSubmitRequest)>
Public Sub FormEvents_OnSubmitRequest(ByVal e As DocReturnEvent)
   ' Get the data connection defined in the form template from the
   ' DataAdapters collection and cast to the SubmitToHostAdapter
   ' type.
   Dim submitAdapter As SubmitToHostAdapter = _
      DirectCast(DataAdapters("MyHostAdapter"), _
      SubmitToHostAdapter)

   ' Write code here to do custom actions that are not 
   ' supported by rules or other declarative settings.

   ' Execute the submit operation against the connection.
   submitAdapter.Submit()
End Sub

Hinweise

Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, finden Sie unterSubmitToHostAdapter .

Dieser Verbindungstyp wird in einer Formularvorlage verwendet, die von einer Anwendung geöffnet wird, die die InfoPath-Formularbearbeitungsumgebung als Steuerelement hostet. Informationen zum Hosten von InfoPath als Steuerelement, einschließlich Informationen zum Erstellen einer Methode zum Behandeln des Ereignisses zum Senden eines Formulars im Code Ihrer Hostanwendung, finden Sie im MSDN-Artikel Hosten der InfoPath-Formularbearbeitungsumgebung in einer benutzerdefinierten Windows Form-Anwendung.

Verwenden Sie den Befehl Datenverbindungen im Menü Extras, um eine Datenverbindung zum Senden von Daten an eine Hostumgebung zu erstellen, auf die von einer Geschäftslogik in einer Formularvorlage verwiesen werden kann. Informationen zum Erstellen eines Ereignishandlers, der ausgeführt wird, wenn das OnSubmitRequest Ereignis ausgelöst wird, finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers mithilfe des InfoPath 2003-Objektmodells.

Eigenschaften

Name

Ruft den Namen des Datenadapters ab, den das SubmitToHostAdapter -Objekt darstellt.

(Geerbt von SubmitToHostAdapter)
QueryAllowed

Die QueryAllowed-Eigenschaft ist für das SubmitToHostAdapter Objekt verfügbar, aber da das SubmitToHostAdapter-Objekt nur zum Übermitteln von Daten verfügbar ist, gibt die Eigenschaft immer false zurück.

(Geerbt von SubmitToHostAdapter)
SubmitAllowed

Die SubmitAllowed-Eigenschaft ist für das SubmitToHostAdapterr-Objekt verfügbar, aber da das SubmitToHostAdapter-Objekt nur zum Übermitteln von Daten verfügbar ist, gibt die Eigenschaft immer true zurück.

(Geerbt von SubmitToHostAdapter)

Methoden

Query()

Die Query-Methode ist für das SubmitToHostAdapter Objekt verfügbar, aber da das SubmitToHostAdapter-Objekt nur zum Übermitteln von Daten verfügbar ist, generiert die Methode immer einen Laufzeitfehler, wenn sie für dieses Objekt aufgerufen wird.

(Geerbt von SubmitToHostAdapter)
Submit()

Führt den Submit-Vorgang für das SubmitToHostAdapter -Objekt aus.

(Geerbt von SubmitToHostAdapter)

Gilt für: