XmlForm.DataSources Свойство

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public:
 abstract property Microsoft::Office::InfoPath::DataSourceCollection ^ DataSources { Microsoft::Office::InfoPath::DataSourceCollection ^ get(); };

public abstract Microsoft.Office.InfoPath.DataSourceCollection DataSources { get; }

member this.DataSources : Microsoft.Office.InfoPath.DataSourceCollection

Public MustOverride ReadOnly Property DataSources As DataSourceCollection

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

DataSourceCollection

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

Примеры

В следующем примере кода свойство XmlFormDataSources класса используется для задания ссылки на дополнительный источник данных 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

Комментарии

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

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

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