Класс DataConnectionCollection

Статья
04/27/2010

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

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

Синтаксис

'Декларация
<DefaultMemberAttribute("Item")> _
Public MustInherit Class DataConnectionCollection
    Implements IEnumerable
'Применение
Dim instance As DataConnectionCollection

[DefaultMemberAttribute("Item")] 
public abstract class DataConnectionCollection : IEnumerable

Заметки

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

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

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

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

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

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

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

Для доступа к экземпляру класса 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.DataConnectionCollection

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

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

См. также

Ссылка

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

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