AdoQueryConnection.Connection-Eigenschaft

Artikel
04/27/2010

Legt die für ein AdoQueryConnection-Objekt verwendete Verbindungszeichenfolge fest oder ruft sie ab.

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

Syntax

'Declaration
Public MustOverride Property Connection As String
'Usage
Dim instance As AdoQueryConnection
Dim value As String

value = instance.Connection

instance.Connection = value

public abstract string Connection { get; set; }

Eigenschaftswert

Die vom AdoQueryConnection-Objekt dargestellte Verbindungszeichenfolge für die Datenverbindung.

Hinweise

Die Connection-Eigenschaft der ADOQueryConnection-Klasse stellt den Zugriff auf die Verbindungszeichenfolge bereit, die von der ADO-Datenverbindung (ActiveX Data Objects) zum Herstellen einer Verbindung mit einer externen ADO-/OLEDB-Datenquelle verwendet wird.

Hinweis

Die ADOQueryConnection-Klasse kann nur bei Microsoft SQL Server- und Microsoft Access-Datenbanken verwendet werden.

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 verwendet der Ereignishandler für ein Steuerelement Button die Connection-Eigenschaft der ADOQueryConnection-Klasse zum Aktualisieren der Verbindungszeichenfolge für die sekundäre Datenquelle Employee. Diese Tabelle soll mithilfe des im ServerName-Feldes eingegebenen Werts in der Hauptdatenquelle auf den neuen Server zeigen. Anschließend wird die Execute-Methode der DataConnection-Klasse für die erneute Abfrage der Datenverbindung auf dem neuen Server verwendet.

public void ChangeServerName_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   //DataConnections collection.
   AdoQueryConnection myAdoQueryConnection = 
      (AdoQueryConnection)(this.DataConnections["Employees"]);
   
   // Get the new server name from the ServerName field in 
   // the main data source.
   XPathNavigator myNav = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:ServerName",
      NamespaceManager);
   string newServer = myNav.InnerXml;

   // Build the new connection string.
   string connectionString = 
      "Provider=SQLOLEDB.1;Integrated Security=SSPI;Persist Security Info=True;";
   connectionString += "Initial Catalog=SalesDB;Data Source=" + 
      newServer;

   // Set the new connection string.
   myAdoQueryConnection.Connection = connectionString;

   // Requery the data source.
   myAdoQueryConnection.Execute();
}

Public Sub ChangeServerName_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   ' Get the Employees connection from 
   ' the DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

   ' Get the new server name from the ServerName field in 
   ' the main data source.
   Dim myNav As XPathNavigator = _
     CreateNavigator().SelectSingleNode("/my:myFields/my:ServerName", _
      NamespaceManager)
   Dim newServer As String = myNav.InnerXml

   ' Build the new connection string.
   Dim connectionString As String = _
      "Provider=SQLOLEDB.1;Integrated Security=SSPI;Persist Security Info=True;"
   connectionString = connectionString & _
      "Initial Catalog=SalesDB;Data Source=" & newServer

   ' Requery the data source.
    myAdoQueryConnection.Execute()
End Sub

Siehe auch

Referenz

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

Freigeben über