AdoSubmitConnection.Connection-Eigenschaft

Artikel
04/27/2010

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

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

Syntax

Public MustOverride Property Connection As String

Dim instance As AdoSubmitConnection
Dim value As String

value = instance.Connection

instance.Connection = value

public abstract string Connection { get; set; }

Eigenschaftswert

Die Verbindungszeichenfolge für die Datenverbindung.

Hinweise

Die Connection-Eigenschaft des ADOSubmitConnection-Objekts bietet Zugriff auf die Verbindungszeichenfolge, die von der ADO-Datenverbindung verwendet wird, um eine Verbindung mit einer externen ActiveX Data Objects/OLEDB-Datenquelle herzustellen.

Wichtig:
Ein ADOSubmitConnection-Objekt kann nur vorhanden sein, wenn ein entsprechendes ADOQueryConnection-Objekt vorhanden ist und die durch beide Objekte dargestellten Datenverbindungen dieselbe Eigenschaftenwertegruppe teilen. Wenn der Wert dieser Eigenschaft für das ADOSubmitConnection-Objekt geändert wird, wird auch der Wert dieser Eigenschaft für das entsprechende ADOQueryConnection-Objekt geändert.

Ein ADOSubmitConnection-Objekt kann nur vorhanden sein, wenn ein entsprechendes ADOQueryConnection-Objekt vorhanden ist und die durch beide Objekte dargestellten Datenverbindungen dieselbe Eigenschaftenwertegruppe teilen. Wenn der Wert dieser Eigenschaft für das ADOSubmitConnection-Objekt geändert wird, wird auch der Wert dieser Eigenschaft für das entsprechende ADOQueryConnection-Objekt geändert.

Hinweis:
Das ADOSubmitConnection-Objekt 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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel verwendet der Ereignishandler für ein Steuerelement Button die Connection-Eigenschaft der AdoSubmitConnection-Klasse, um die Verbindungszeichenfolge für die sekundäre Datenquelle namens Employees zu aktualisieren, um auf einen neuen Server zu zeigen. Dafür wird der Wert verwendet, der im Feld ServerName in der primären Datenquelle eingegeben wurde. Dann wird mithilfe der Execute-Methode der DataConnection-Klasse die Datenverbindung auf dem neuen Server erneut abgefragt.

public void ChangeServerName_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   //DataConnections collection.
   AdoSubmitConnection myAdoSubmitConnection = 
      (AdoSubmitConnection)(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.
   myAdoSubmitConnection.Connection = connectionString;

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

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

   ' 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.
    myAdoSubmitConnection.Execute()
End Sub

Siehe auch

Referenz

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

Freigeben über