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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in 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)