XmlForm.QueryDataConnection-Eigenschaft
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
Get
'Usage
Dim instance As XmlForm
Dim value As DataConnection
value = instance.QueryDataConnection
public abstract DataConnection QueryDataConnection { get; }
Eigenschaftswert
Typ: Microsoft.Office.InfoPath.DataConnection
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.
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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Codebeispiel wird mithilfe der QueryDataConnection-Eigenschaft der XmlForm-Klasse ein Verweis auf die der Formularvorlage zugeordneten ADOQueryConnection- und ADOSubmitConnection-Objekte festgelegt. Anschließend wird 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)