DataAdaptersCollection 介面

包含資料配接器物件，該物件對應至 Microsoft Office InfoPath 2007 表單內所使用的每個資料連接。

**命名空間：**Microsoft.Office.Interop.InfoPath
**組件：**Microsoft.Office.Interop.InfoPath (於 microsoft.office.interop.infopath.dll 中)

語法

'宣告
<GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(DataAdaptersCollectionClass))> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters
'用途
Dim instance As DataAdaptersCollection

[GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(DataAdaptersCollectionClass))] 
public interface DataAdaptersCollection : DataAdapters

備註

此類型為 coclass 實作之 COM 介面的包裝函式，屬於 COM 互通性中 Managed 程式碼的必要項。使用包裝實作此介面之 coclass 的類型，即可存取此介面指定的成員。如需該類型 (包括用法、備註及範例) 的詳細資訊，請參閱 DataAdapters。

每個資料連接都是用以擷取資料 (插入主要資料來源中或次要資料來源中的資料) 或送出資料。

擷取主要資料來源資料所使用的資料連接，將會對應至下列其中一個資料配接器物件類型：

• ADOAdapterObject

• WebServiceAdapterObject

注意

擷取主要資料來源資料所使用的 ADOAdapter 物件也可以送出資料。

擷取次要資料來源資料所使用的資料連接，將會對應至下列其中一個資料配接器物件類型：

• ADOAdapterObject

• SharepointListAdapterObject

• WebServiceAdapterObject

• XMLFileAdapterObject

只用來送出資料的資料連接，將會對應至下列其中一個資料配接器物件類型：

• EmailAdapterObject

• DAVAdapterObject

• HWSAdapterObject

• WebServiceAdapterObject

DataAdapters 集合可以使用 XDocument 物件的 DataAdapters 屬性來存取。

注意

若要使用資料配接器物件的屬性或方法，在存取該成員之前，您必須將從 DataAdaptersCollection 物件傳回的物件轉換為其所代表的指定資料配接器。如需關於使用資料配接器的詳細資訊，請參閱操作方法：存取外部資料來源

範例

在下列範例中，是從 DataAdapters 集合擷取連線到 Northwind 資料庫之 Employees 資料表的 ADOAdapter 物件：

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

在下列範例中，是從 DataAdapters 集合擷取稱為 "form1" 的 XML 文件 (當做 XML 檔案資料連接)，並且在訊息方塊中顯示連線的各種屬性：

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

請參閱

參考

DataAdaptersCollection 成員
Microsoft.Office.Interop.InfoPath 命名空間