AdoSubmitConnection.Connection, propriété

Article
04/27/2010

Obtient ou définit la chaîne de connexion utilisée pour un objet AdoSubmitConnection.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

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; }

Valeur de la propriété

Chaîne de connexion pour la connexion de données.

Remarques

La propriété Connection de l'objet ADOSubmitConnection fournit l'accès à la chaîne de connexion utilisée par la connexion de données ADO pour se connecter à une source de données externe ADO (ActiveX Data Objects)/OLEDB.

Important :
Un objet ADOSubmitConnection ne peut exister que s'il y a un objet ADOQueryConnection correspondant. Les connexions de données représentées par ces deux objets partagent aussi le même ensemble de valeurs de propriété. La modification de la valeur de cette propriété pour l'objet ADOSubmitConnection entraîne également celle de la valeur de la même propriété pour l'objet ADOQueryConnection correspondant.

Un objet ADOSubmitConnection ne peut exister que s'il y a un objet ADOQueryConnection correspondant. Les connexions de données représentées par ces deux objets partagent aussi le même ensemble de valeurs de propriété. La modification de la valeur de cette propriété pour l'objet ADOSubmitConnection entraîne également celle de la valeur de la même propriété pour l'objet ADOQueryConnection correspondant.

Remarque
L'objet ADOSubmitConnection est limité pour fonctionner uniquement avec des bases de données Microsoft SQL Server et Microsoft Access.

Ce membre est accessible uniquement par les formulaires qui s'exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d'autorisations indépendantes des domaines.

Ce type ou ce membre est uniquement accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007.

Exemple

Dans l'exemple ci-dessous, le gestionnaire d'événements d'un contrôle Button utilise la propriété Connection de la classe AdoSubmitConnection pour mettre à jour la chaîne de connexion de la source de données secondaire Employés afin qu'elle pointe vers un nouveau serveur à l'aide de la valeur entrée dans le champ ServerName de la source de données principale. Ensuite, la méthode Execute de la classe DataConnection est utilisée pour interroger à nouveau la connexion de données sur le nouveau serveur.

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

Voir aussi

Référence

AdoSubmitConnection, classe
Membres AdoSubmitConnection
Microsoft.Office.InfoPath, espace de noms

Partager via