DataAdaptersCollection 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包含对应于 Microsoft InfoPath 表单中使用的每个数据连接的数据适配器对象。
public interface class DataAdaptersCollection : Microsoft::Office::Interop::InfoPath::SemiTrust::DataAdapters
[System.Runtime.InteropServices.Guid("096cd692-0786-11d1-95fa-0080c78ee3bb")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.SemiTrust.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;
XMLFileAdapterObject xmlFileAdapterObject;
dataAdapters = thisXDocument.<span class="label">DataAdapters</span>;
xmlFileAdapterObject = dataAdapters["form1"] as XMLFileAdapterObject;
if (xmlFileAdapterObject == null)
{
thisXDocument.UI.Alert("The DataAdapter does not exist or is not an XMLFileAdapterObject.");
}
else
{
thisXDocument.UI.Alert("XML file adapter" + "\n\n" + "Name: " + xmlFileAdapterObject.Name + "\n" + "QueryAllowed: " + xmlFileAdapterObject.QueryAllowed+ "\n" + "SubmitAllowed: " + xmlFileAdapterObject.SubmitAllowed+ "\n" + "FileURL: " + xmlFileAdapterObject.FileURL);
// Perform the query.
try
{
xmlFileAdapterObject.Query();
}
catch (Exception ex)
{
thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
}
// Perform the submit.
try
{
xmlFileAdapterObject.Submit();
}
catch (Exception ex)
{
thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
}
}
注解
此类型是用于 Coclass(托管代码需要此 Coclass 来实现 COM 互操作性)的包装。 使用此类型来访问由此 Coclass 实现的 COM 接口。 有关 COM 接口的信息(包括指向其成员说明的链接),请参阅DataAdapters。
每个数据连接都用于检索数据(插入到主数据源或辅助数据源中的数据)或提交数据。
用于检索主数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:
注意:用于检索main数据源数据的 ADOAdapter 对象也可以提交数据。
用于检索辅助数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:
仅用于提交数据的数据连接将与下面的数据适配器对象类型之一相对应:
可以使用 对象的 属性XDocument访问 DataAdaptersDataAdapters 集合。
注意:若要使用数据适配器对象的属性或方法,必须先将从 DataAdaptersCollection 对象返回的对象强制转换为它所代表的特定数据适配器,然后才能访问这些成员。 有关使用数据适配器的详细信息,请参阅如何:使用 InfoPath 2003 对象模型访问外部数据源。
属性
Count |
获取集合中的数据 DataAdaptersCollection 适配器数。 (继承自 DataAdapters) |
Item[Object] |
根据位置或名称从集合中 DataAdaptersCollection 获取对指定数据适配器对象的引用。 (继承自 DataAdapters) |
方法
GetEnumerator() |
获取一个循环访问对象中所有条目的 DataAdaptersEnumeratorIEnumerator。 (继承自 DataAdapters) |