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
コメント
この型は、COM 相互運用のためにマネージ コードで必要とされるコクラスによって実装される COM インターフェイスのラッパーです。このインターフェイスによって指定されるメンバにアクセスするには、このインターフェイスを実装するコクラスをラップする型を使用します。この型については (使用例、解説、およびサンプル コードを含む)、次を参照してください DataAdapters.
各データ接続は、メイン データ ソースまたはセカンダリ データ ソースに挿入されたデータを取得したり、データを送信したりするために使用されます。
メイン データ ソースのデータの取得に使用されるデータ接続は、次のいずれかの種類のデータ アダプタ オブジェクトに対応します。
![]() |
---|
メイン データ ソースのデータの取得に使用される ADOAdapter オブジェクトは、データを送信することもできます。 |
セカンダリ データ ソースのデータの取得に使用されるデータ接続は、次のいずれかの種類のデータ アダプタ オブジェクトに対応します。
ADOAdapterObject
WebServiceAdapterObject
データの送信のみに使用されるデータ接続は、次のいずれかの種類のデータ アダプタ オブジェクトに対応します。
WebServiceAdapterObject
DataAdapters コレクションには、XDocument オブジェクトの DataAdapters プロパティを使用してアクセスできます。
![]() |
---|
データ アダプタ オブジェクトのプロパティやメソッドを使用するには、これらのメンバにアクセスする前に、DataAdaptersCollection オブジェクトから返されたオブジェクトを、そのオブジェクトが表す特定のデータ アダプタにキャストする必要があります。データ アダプタの使い方の詳細については、「[方法] 外部データ ソースへのアクセス方法」を参照してください。 |
例
次の例では、Northwind データベースの Employees テーブルに接続されている ADOAdapter オブジェクトを DataAdapters コレクションから取得します。
// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.DataAdapters["Employees"];
次の例では、XML ファイル データ接続として使用できる、"form1" という名前の XML ドキュメントを、DataAdapters コレクションから取得します。この接続のさまざまなプロパティがメッセージ ボックスに表示されます。
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 名前空間