XmlForm.DataSources 속성

양식에 연결된 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; }

속성 값

양식에 연결된 모든 DataSource 개체를 포함하는 DataSourceCollection입니다.

주의

DataSourceCollection 개체는 양식 서식 파일에 연결된 모든 외부(보조) 데이터 원본을 나타내는 DataSource 개체의 컬렉션입니다. 또한 DataSourceCollection 개체는 양식의 주 데이터 원본을 나타내는 DataSource 개체도 포함합니다. 이는 개발자가 두 가지 방법 즉, DataSourceCollection[""]을 사용하거나 MainDataSource 속성을 사용하여 주 데이터 원본을 나타내는 DataSource 개체를 반환할 수 있음을 의미합니다.

참고:
DataSources 속성은 COM/스크립팅 개체 모델에서는 XDocument 개체의 DataObjects 속성, InfoPath 2003 호환 관리 코드 개체 모델에서는 _XDocument2 인터페이스의 DataObjects 속성과 유사한 기능을 제공합니다.

이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.

이 형식 또는 구성원은 Microsoft Office InfoPath 2007 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.

예제

다음 예제에서는 XmlForm 클래스의 DataSources 속성을 사용하여 "CityList" 보조 데이터 속성에 대한 참조를 설정합니다.

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

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

다음 예제에서는 양식의 단추 컨트롤에 대한 이벤트 처리기를 구현하며 XmlForm 개체의 DataSources 속성을 사용하여 양식의 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 네임스페이스