Класс DataConnection

Статья
04/27/2010

Представляет базовый класс, из которого производится каждый отдельный тип подключения данных.

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

Синтаксис

'Декларация
Public MustInherit Class DataConnection
'Применение
Dim instance As DataConnection

public abstract class DataConnection

Заметки

Каждое подключение данных используется для извлечения данных (вставленных в основной или дополнительный источник данных) или их отправки.

Подключение данных, используемое для извлечения или отправки данных в основном источнике данных, будет соответствовать одному из следующих типов объекта подключения данных:

Объекты AdoQueryConnection или AdoSubmitConnection
Объект WebServiceConnection

Подключение данных, используемое для извлечения данных в дополнительном источнике данных, будет соответствовать одному из следующих типов объекта подключения данных:

ADOQueryConnection
Объект SharepointListQueryConnection
Объект WebServiceConnection
Объект FileQueryConnection

Подключение данных, используемое только для отправки данных, будет соответствовать одному из следующих типов объекта подключения данных:

Объект EmailSubmitConnection
Объект FileSubmitConnection
Объект WebServiceConnection

Для доступа к объекту DataConnection отдельного типа подключения данных используйте объект DataConnectionCollection, связанный с шаблоном формы. Для доступа к объекту DataConnectionCollection используйте свойство DataConnections класса XmlForm.

Для использования свойств и методов, возвращенных из объекта DataConnectionCollection, необходимо преобразовать этот объект в тип, представляющий вид подключения данных, с которым работает пользователь, до того, как можно будет обратиться к членам объекта. Например, для работы с объектом AdoQueryConnection (который представляет подключение данных для извлечения данных из базы данных Access или SQL Server), необходимо преобразовать объект, возвращенный из объекта DataConnectionCollection, как показано в следующих примерах.

   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

Дополнительные сведения о работе с подключениями данных, см. в разделе Практическое руководство. Доступ к внешним источникам данных.

Иерархия наследования

System.Object
Microsoft.Office.InfoPath.DataConnection
Производные классы

Безопасность потока

Все открытые статические (Общие в Visual Basic) члены этого типа потокобезопасны. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылка

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

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