DataAdaptersCollection 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包含与 Microsoft InfoPath 表单中使用的每个数据连接对应的数据适配器对象。
public interface class DataAdaptersCollection : Microsoft::Office::Interop::InfoPath::DataAdapters
[System.Runtime.InteropServices.Guid("096CD692-0786-11D1-95FA-0080C78EE3BB")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.DataAdapters
type DataAdaptersCollection = interface
interface DataAdapters
Public Interface DataAdaptersCollection
Implements DataAdapters
- 派生
- 属性
- 实现
示例
在以下示例中,连接到 Northwind 数据库的“Employees”表的 ADOAdapter 对象可从 DataAdapters 集合检索:
// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.<span class="label">DataAdapters</span>["Employees"];
在以下示例中,名为“form1”的 XML 文档(可用作 XML 文件数据连接)可从 DataAdapters 集合检索。 在消息框中显示连接的各种属性:
<span class="label">DataAdapters</span> dataAdapters;
dataAdapters = thisXDocument.<span class="label">DataAdapters</span>;
XMLFileAdapterObject queryXMLFile = (XMLFileAdapterObject)dataAdapters["form1"];
thisXDocument.UI.Alert("Query - XML file adapter");
thisXDocument.UI.Alert("Name: " + queryXMLFile.Name);
thisXDocument.UI.Alert("QueryAllowed: " + queryXMLFile.QueryAllowed);
thisXDocument.UI.Alert("SubmitAllowed: " + queryXMLFile.SubmitAllowed);
thisXDocument.UI.Alert("FileURL: " + queryXMLFile.FileURL);
// Perform the query.
try
{
queryXMLFile.Query();
}
catch (Exception ex)
{
thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
}
// Perform the submit.
try
{
queryXMLFile.Submit();
}
catch (Exception ex)
{
thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
}
注解
此类型是用于由 Coclass(托管代码需要此 Coclass 来实现 COM 互操作性)实现的 COM 接口的包装。 要访问由此接口指定的成员,请使用用于包装实现此接口的 Coclass 的类型。 有关该类型的信息(包括用法、备注和示例),请参阅DataAdapters。
每个数据连接都用于检索数据(插入到主数据源或辅助数据源中的数据)或提交数据。
用于检索主数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:
注意:用于检索主数据源数据的 ADOAdapter 对象也可以提交数据。
用于检索辅助数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:
仅用于提交数据的数据连接将与下面的数据适配器对象类型之一相对应:
可以使用 对象的 属性XDocument访问 DataAdaptersDataAdapters 集合。
注意:若要使用数据适配器对象的属性或方法,必须先将从 DataAdaptersCollection 对象返回的对象强制转换为它所代表的特定数据适配器,然后才能访问这些成员。 有关使用数据适配器的详细信息,请参阅如何:访问外部数据源
属性
Count |
获取集合中的数据 DataAdaptersCollection 适配器数。 (继承自 DataAdapters) |
Item[Object] |
根据位置或名称从集合中 DataAdaptersCollection 获取对指定数据适配器对象的引用。 (继承自 DataAdapters) |
方法
GetEnumerator() |
获取循环访问集合中所有条目的 DataAdaptersIEnumerator。 (继承自 DataAdapters) |