AdoSubmitConnection.Connection Eigenschaft

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die für ein AdoSubmitConnection -Objekt verwendete Verbindungszeichenfolge ab oder legt diese fest.

public:
 abstract property System::String ^ Connection { System::String ^ get(); void set(System::String ^ value); };

public abstract string Connection { get; set; }

member this.Connection : string with get, set

Public MustOverride Property Connection As String

Eigenschaftswert

String

Die Verbindungszeichenfolge für die Datenverbindung.

Beispiele

Im folgenden Beispiel verwendet der Ereignishandler für ein Button-Steuerelement die Connection-Eigenschaft der AdoSubmitConnection-Klasse, um die Verbindungszeichenfolge für die sekundäre Datenquelle mit dem Namen Employees so zu aktualisieren, dass sie auf einen neuen Server verweist, indem der Wert verwendet wird, der in das Feld ServerName in der Standard Datenquelle eingegeben wurde. Anschließend wird die Execute() -Methode der DataConnection -Klasse verwendet, um die Datenverbindung auf dem neuen Server erneut abzufragen.

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 &amp; _
      "Initial Catalog=SalesDB;Data Source=" &amp; newServer

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

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 datenverbindungen, die von beiden Objekten dargestellt werden, denselben Satz von Eigenschaftswerten verwenden. 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 mit Microsoft SQL Server- und Microsoft Access-Datenbanken verwendet werden.

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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über