AdoQueryConnection.Connection - Propriété
Obtient ou définit la chaîne de connexion utilisée pour un objet AdoQueryConnection.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Property Connection As String
Get
Set
'Utilisation
Dim instance As AdoQueryConnection
Dim value As String
value = instance.Connection
instance.Connection = value
public abstract string Connection { get; set; }
Valeur de propriété
Type : System.String
Chaîne de connexion de la connexion de données représentée par l'objet AdoQueryConnection.
Remarques
La propriété Connection de la classe ADOQueryConnection contient la chaîne de connexion utilisée par la connexion de données ADO pour se connecter à une source de données externe ADO/OLEDB.
Notes
L'utilisation de la classe ADOQueryConnection est limitée aux bases de données Microsoft SQL Server et Microsoft Access.
Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.
Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.
Exemples
Dans l'exemple suivant, le gestionnaire d'événements d'un contrôle Button utilise la propriété Connection de la classe ADOQueryConnection pour mettre à jour la chaîne de connexion de la source de données secondaire appelée Employees afin qu'elle pointe vers un nouveau serveur grâce à la valeur indiquée dans le champ ServerName dans la source de données principale. Ensuite, la méthode Execute de la classe DataConnection est appelée pour actualiser la connexion de donnée au nouveau serveur.
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