Свойство AdoSubmitConnection.Connection

Статья
04/27/2010

Возвращает или задает строку подключения, используемую для объекта AdoSubmitConnection.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
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; }

Значение свойства

Строка подключения для подключения данных.

Заметки

Свойство Connection объекта ADOSubmitConnection предоставляет доступ к строке подключения, которая используется ADO-подключением для подключения к внешнему источнику данных ADO или OLEDB.

Внимание!
Объект ADOSubmitConnection может существовать только с соответствующим объектом ADOQueryConnection, и подключения данных, представленные обоими объектами, используют одинаковый набор значений свойств. При изменении значения свойства для объекта ADOSubmitConnection также изменяется значение того же свойства соответствующего объекта ADOQueryConnection.

Объект ADOSubmitConnection может существовать только с соответствующим объектом ADOQueryConnection, и подключения данных, представленные обоими объектами, используют одинаковый набор значений свойств. При изменении значения свойства для объекта ADOSubmitConnection также изменяется значение того же свойства соответствующего объекта ADOQueryConnection.

Заметка
Объект ADOSubmitConnection предназначен для работы только с базами данных Microsoft SQL Server и Microsoft Access.

Доступ к этому члену имеется только у форм, запускаемых на том же домене, что и открытая в настоящий момент форма, или у форм, которым были присвоены междоменные разрешения.

Доступ к этому типу или члену имеется только из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007.

Пример

В следующем примере обработчик события элемента управления Button использует свойство Connection класса AdoSubmitConnection, чтобы обновить строку подключения для дополнительного источника данных с именем Employees и указать новый сервер с помощью значения, введенного в поле ServerName в основном источнике данных. Затем метод Execute класса DataConnection используется, чтобы повторно запросить подключение данных на новом сервере.

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

См. также

Ссылка

Класс AdoSubmitConnection
Члены AdoSubmitConnection
Пространство имен Microsoft.Office.InfoPath

Поделиться через