Свойство XmlForm.DataSources

Статья
04/27/2010

Возвращает объект DataSourceCollection, связанный с формой.

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

Синтаксис

'Декларация
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
'Применение
Dim instance As XmlForm
Dim value As DataSourceCollection

value = instance.DataSources

public abstract DataSourceCollection DataSources { get; }

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

Коллекция DataSourceCollection, которая содержит любые объекты DataSource, связанные с формой.

Заметки

Объект DataSourceCollection, который содержит коллекцию объектов DataSource, представляющих все внешние (дополнительные) источники данных, связанных с шаблоном формы. Объект DataSourceCollection также содержит объект DataSource, представляющий основной источник данных формы. Это означает, что у разработчиков будет два способа возвращения объекта DataSource, представляющего основной источник данных: с помощью DataSourceCollection[""] или свойства MainDataSource.

Заметка
Свойство DataSources обеспечивает те же функциональные возможности, что и свойство DataObjects объекта XDocument в объектной модели COM или сценариев и свойство DataObjects интерфейса _XDocument2 объектной модели управляемого кода, совместимой с InfoPath 2003.

Свойство DataSources обеспечивает те же функциональные возможности, что и свойство DataObjects объекта XDocument в объектной модели COM или сценариев и свойство DataObjects интерфейса _XDocument2 объектной модели управляемого кода, совместимой с InfoPath 2003.

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

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

Пример

В следующем примере свойство DataSources класса XmlForm используется для установки ссылки на дополнительный источник данных "CityList".

DataSource myDataSource = this.DataSources["CityList"];

Dim myDataSource As DataSource = Me.DataSources("CityList")

В следующем примере, в котором реализован обработчик события для элемента управления в форме, свойство DataSources объекта XmlForm используется для установки ссылки на объект DataSourceCollection формы. Код выполняет цикл по коллекции и отображает позиционный индекс и имя каждого объекта DataSource, который она содержит.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   // Set a reference to the DataSources collection.
   DataSourceCollection myDataSources = this.DataSources;

   // Loop through the collection and display the name
   // of each DataSource object that it contains.
   for (int i = 0; i < myDataSources.Count; i++)
   {
      MessageBox.Show("Data source " + i + ": " + 
         myDataSources[i].Name);
   }
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   ' Set a reference to the DataSources collection.
   Dim myDataSources As DataSourceCollection = Me.DataSources

   ' Loop through the collection and display the name
   ' of each DataSource object that it contains.
   Dim i As Integer
   For i = 0 To myDataSources.Count - 1
      MessageBox.Show("Data source " & i & ": " _
         & myDataSources(i).Name)
   Next
End Sub

См. также

Ссылка

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

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