Proprietà AdoSubmitConnection.Connection

Articolo
04/27/2010

Ottiene o imposta la stringa di connessione utilizzata per un oggetto AdoSubmitConnection.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

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

Valore proprietà

Stringa di connessione per la connessione dati.

Osservazioni

La proprietà Connection dell'oggetto ADOSubmitConnection consente di accedere alla stringa utilizzata dalla connessione dati ADO per connettersi a un'origine dati esterna ADO (ActiveX Data Objects)/OLEDB.

Importante:
Un oggetto ADOSubmitConnection può essere presente solo quando è presente un oggetto ADOQueryConnection corrispondente e le connessioni dati rappresentate da entrambi gli oggetti condividono lo stesso set di valori delle proprietà. Modificando il valore di questa proprietà per l'oggetto ADOSubmitConnection viene modificato anche il valore della stessa proprietà per l'oggetto ADOQueryConnection corrispondente.

Un oggetto ADOSubmitConnection può essere presente solo quando è presente un oggetto ADOQueryConnection corrispondente e le connessioni dati rappresentate da entrambi gli oggetti condividono lo stesso set di valori delle proprietà. Modificando il valore di questa proprietà per l'oggetto ADOSubmitConnection viene modificato anche il valore della stessa proprietà per l'oggetto ADOQueryConnection corrispondente.

Nota:
L'oggetto ADOSubmitConnection può essere utilizzato solo con i database di Microsoft SQL Server e di Microsoft Access.

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007.

Esempio

Nell'esempio seguente viene utilizzata, dal gestore eventi per un controllo Button, la proprietà Connection della classe AdoSubmitConnection per aggiornare la stringa di connessione per l'origine dati secondaria denominata Employees affinché punti a un nuovo server, utilizzando il valore immesso nel campo ServerName dell'origine dati principale. Viene quindi utilizzato il metodo Execute della classe DataConnection per eseguire una nuova query nella connessione dati nel nuovo server.

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

Vedere anche

Riferimenti

Classe AdoSubmitConnection
Membri AdoSubmitConnection
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite