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"];
次の例では、XML ファイル データ接続として使用できる、"form1" という名前の 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);
}
注釈
この型は、COM の相互運用性を得るためにマネージ コードが必要とするコクラスのラッパーです。 このインターフェイスによって指定されたメンバにアクセスするには、このインターフェイスを実装するコクラスをラップする型を使用します。 使用法、備考、例など、その種類の詳細については、「」を参照してくださいDataAdapters。
各データ接続は、メイン データ ソースまたはセカンダリ データ ソースに挿入されたデータを取得したり、データを送信したりするために使用されます。
メイン データ ソースのデータの取得に使用されるデータ接続は、次のどちらかの種類のデータ アダプター オブジェクトに対応します。
注: メイン データ ソースのデータを取得するために使用される ADOAdapter オブジェクトは、データを送信することもできます。
セカンダリ データ ソースのデータの取得に使用されるデータ接続は、次のいずれかの種類のデータ アダプター オブジェクトに対応します。
データの送信のみに使用されるデータ接続は、次のいずれかの種類のデータ アダプター オブジェクトに対応します。
DataAdapters コレクションには、 オブジェクトの XDocument プロパティをDataAdapters使用してアクセスできます。
注: データ アダプター オブジェクトのプロパティまたはメソッドを使用するには、 DataAdaptersCollection オブジェクトから返されたオブジェクトを、それらのメンバーにアクセスする前に、そのオブジェクトが表す特定のデータ アダプターにキャストする必要があります。 データ アダプターの操作の詳細については、「方法: 外部データ ソースにアクセスする」を参照してください。
プロパティ
Count |
コレクション内 DataAdaptersCollection のデータ アダプターの数を取得します。 (継承元 DataAdapters) |
Item[Object] |
位置または名前に基づいて、コレクションから DataAdaptersCollection 指定したデータ アダプター オブジェクトへの参照を取得します。 (継承元 DataAdapters) |
メソッド
GetEnumerator() |
コレクション内のすべてのエントリを反復処理する IEnumerator を DataAdapters 取得します。 (継承元 DataAdapters) |