XmlForm.DataSources 속성
양식에 연결된 DataSourceCollection 개체를 가져옵니다.
네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)
구문
‘선언
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
Get
‘사용 방법
Dim instance As XmlForm
Dim value As DataSourceCollection
value = instance.DataSources
public abstract DataSourceCollection DataSources { get; }
속성 값
형식: Microsoft.Office.InfoPath.DataSourceCollection
양식에 연결된 모든 DataSource 개체를 포함하는 DataSourceCollection입니다.
주의
DataSourceCollection 개체는 양식 서식 파일에 연결된 모든 외부(보조) 데이터 원본을 나타내는 DataSource 개체의 컬렉션입니다. 또한 DataSourceCollection 개체는 양식의 기본 데이터 원본을 나타내는 DataSource 개체도 포함합니다. 이는 개발자가 두 가지 방법 즉, DataSources[""]을 사용하거나 MainDataSource 속성을 사용하여 기본 데이터 원본을 나타내는 DataSource 개체를 반환할 수 있음을 의미합니다.
이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.
이 형식 또는 멤버는 Microsoft InfoPath Filer 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서 액세스할 수 있습니다.
예
다음 코드 예제에서는 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