一个数据源的数据成员集合。

语法

DataMembers

说明

数据供应程序可以有多组数据供数据使用者选择以绑定到其上。每组数据都称作一个“数据成员”，它可以是一个ADO Recordset、可以是提供OLE Simple Provider（OSP）界面的Class，也可以是用Visual Basic创建的OLEDB供应程序。在任何情况下，一个任意但唯一的字符串可以同数据成员关联起来，并且这个标识字符串正是就是使用Add方法加入到DataMembers集合中的。

当配置一个使用复杂数据源的数据使用者时，必须同时设置DataSource和DataMember两个属性以完全限定一个数据源。例如，如果配置一个使用Data Environment作为数据源的TextBox控件，必须设置它的DataSource属性为Data Environment，并且设置它的DataMember属性为特定的Command对象。相反，当您创建自己的复杂数据源时，DataMembers集合允许您的数据源为任何的数据使用者提供多组数据。

例如，通过设置DataSourceBehavior为vbDataSource，可以创建一个配置为数据源的User Control。在Initialize事件中，使用Add方法把每一个数据成员的标识字符串添加到DataMembers集合。结果，当最终用户设置DataSource属性为您的用户控件，并且单击“属性”窗口的DataMembers时，添加到DataMembers集合的那些成员就会显现在下拉列表中。

类似地，当创建一个配置为数据源的Class时，在Initialize事件中，调用Add方法把标识字符串添加到DataMembers集合。然后，要配置使用该类的一个数据使用者，需要把它的DataSource属性设置为该类，并且把它的DataMember属性设置为DataMembers集合的一个成员。

当数据使用者的DataSource属性设置为一个类或者被配置为数据源的User control时，GetDataMember事件发生。该事件包含一个DataMember参数，它传递DataMember属性的值。该事件还有一个Data参数，您可以使用它返回数据给使用者。换句话说，在GetDataMember事件中，查询DataMember值可以决定哪个数据成员已经被请求，并且设置该事件的Data参数为被请求的数据源（例如，ADO记录集、OLEDB供应程序或实现OSP接口的类）。

数据成员也可以是一个空串。当为GetDataMember事件编程时，请一定通过设置缺省的数据成员来处理这种可能性。