XmlForm.QueryDataConnection-Eigenschaft

Artikel
04/27/2010

Ruft einen Verweis auf das DataConnection-Objekt ab, das die dem Formular zugeordnete Datenverbindung darstellt.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride ReadOnly Property QueryDataConnection As DataConnection
'Usage
Dim instance As XmlForm
Dim value As DataConnection

value = instance.QueryDataConnection

public abstract DataConnection QueryDataConnection { get; }

Eigenschaftswert

Ein DataConnection-Objekt, das die dem Formular zugeordnete Datenverbindung darstellt.

Hinweise

DataConnection-Objekte stellen Eigenschaften und Methoden bereit, die Daten von externen Datenquellen abrufen oder diese an externe Datenquellen senden. Die einem Formular zugeordnete Datenverbindung hängt dabei vom Datenquellentyp ab, der beim ursprünglichen Erstellen des Formulars verwendet wurde.

Die QueryDataConnection-Eigenschaft ermöglicht Ihnen den Zugriff auf die primäre Datenquelle eines InfoPath-Formulars. Um auf die Datenadapterobjekte zuzugreifen, die für die sekundären Datenquellen eines Formulars verwendet werden, verwenden Sie die DataSources-Eigenschaft.

Hinweis

Die QueryDataConnection-Eigenschaft stellt ähnliche Funktionalität für die QueryAdapter-Eigenschaft des XDocument-Objekts im COM/Skript-Objektmodell sowie für die QueryAdapter-Eigenschaft der _XDocument2-Benutzeroberfläche des InfoPath 2003-kompatiblen Objektmodells mit verwaltetem Code bereit.

Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird mithilfe der QueryDataConnection-Eigenschaft der XmlForm-Klasse ein Verweis auf die der Formularvorlage zugeordneten ADOQueryConnection- und ADOSubmitConnection-Objekte festgelegt. Anschließend werden mithilfe der Command-Eigenschaft des ADOQueryConnection-Objekts und mithilfe der Command-Eigenschaft der ADOQueryConnection-Objekte der SQL-Befehltext für jeden Verbindungstyp in einem Meldungsfeld angezeigt.

ADOQueryConnection queryConnection;
ADOSubmitConnection submitConnection;

queryConnection = (ADOQueryConnection) this.QueryConnection;
MessageBox.Show("Query SQL command text: " + queryConnection.Command);

submitConnection = (ADOSubmitConnection) this.QueryConnection;
MessageBox.Show("Submit SQL command text: " + querySubmit.Command);
Dim queryConnection As ADOQueryConnection
Dim submitConnectionmAs ADOSubmitConnection

queryConnection = DirectCast(ADOQueryConnection, Me.QueryConnection)
MessageBox.Show("Query SQL command text: " & queryConnection.Command)

submitConnection = DirectCast(ADOSubmitConnection, Me.QueryConnection)
MessageBox.Show("Submit SQL command text: " & querySubmit.Command)

Siehe auch

Referenz

XmlForm-Klasse
XmlForm-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über