Share via


DataAdaptersCollection 接口

包含与 Microsoft InfoPath 表单中所用的每个数据连接相对应的数据适配器对象。

命名空间:  Microsoft.Office.Interop.InfoPath.SemiTrust
程序集:  Microsoft.Office.Interop.InfoPath.SemiTrust(位于 Microsoft.Office.Interop.InfoPath.SemiTrust.dll 中)

语法

声明
<GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface DataAdaptersCollection _
    Inherits DataAdapters
用法
Dim instance As DataAdaptersCollection
[GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")]
public interface DataAdaptersCollection : DataAdapters

备注

此类型是用于 Coclass(托管代码需要此 Coclass 来实现 COM 互操作性)的包装。使用此类型来访问由此 Coclass 实现的 COM 接口。有关 COM 接口的信息(包括指向其成员说明的链接),请参阅DataAdapters.

每个数据连接都用于检索数据(插入到主数据源或辅助数据源中的数据)或提交数据。

用于检索主数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:

备注

用于检索主数据源中数据的 ADOAdapter 对象也可以提交数据。

用于检索辅助数据源中数据的数据连接将与下面的数据适配器对象类型之一相对应:

仅用于提交数据的数据连接将与下面的数据适配器对象类型之一相对应:

可以使用 XDocument 对象的 DataAdapters 属性访问 DataAdapters 集合。

备注

要使用数据适配器对象的属性或方法,需要将从 DataAdaptersCollection 对象返回的对象转换为它所代表的特定数据适配器,然后才能访问这些成员。有关使用数据适配器的详细信息,请参阅如何:使用 InfoPath 2003 对象模型访问外部数据源

示例

在以下示例中,连接到 Northwind 数据库的"Employees"表的 ADOAdapter 对象可从 DataAdapters 集合检索:

// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.DataAdapters["Employees"];

在以下示例中,名为"form1"的 XML 文档(可用作 XML 文件数据连接)可从 DataAdapters 集合检索。在消息框中显示连接的各种属性:

DataAdapters dataAdapters;
XMLFileAdapterObject xmlFileAdapterObject;

dataAdapters = thisXDocument.DataAdapters; 
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);
 }
}

另请参阅

引用

DataAdaptersCollection 成员

Microsoft.Office.Interop.InfoPath.SemiTrust 命名空间