DataConnectionCollection クラス
フォーム テンプレート内で使用されている各データ接続に対応するデータ接続オブジェクトが格納されます。
継承階層
System.Object
Microsoft.Office.InfoPath.DataConnectionCollection
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustInherit Class DataConnectionCollection _
Implements IEnumerable
'使用
Dim instance As DataConnectionCollection
public abstract class DataConnectionCollection : IEnumerable
解説
各データ接続は、メイン データ ソースまたはセカンダリ データ ソースに挿入されたデータを取得したり、データを送信したりするために使用されます。
メイン データ ソースに関するデータの取得または送信に使用されるデータ接続は、次のいずれかのデータ接続オブジェクト型に対応しています。
セカンダリ データ ソースのデータの取得に使用されるデータ接続は、次のいずれかのデータ接続オブジェクト型に対応しています。
SharePointListRWQueryConnection
注意
以前のバージョンの InfoPath で使用された SharepointListQueryConnection オブジェクトは現在使用されていません。
データの送信だけに使用されるデータ接続は、次のいずれかのデータ接続オブジェクト型に対応しています。
特定の種類のデータ接続用の DataConnection オブジェクトにアクセスするには、フォーム テンプレートと関連付けられている DataConnectionCollection オブジェクトを使用します。DataConnectionCollection オブジェクトにアクセスするには、XmlForm クラスの DataConnections プロパティを使用します。
DataConnectionCollection から返されるオブジェクトのプロパティまたはメソッドを使用するには、これらのメンバーにアクセスする前に、作業対象とするデータ接続の種類を表す型にオブジェクトをキャストする必要があります。たとえば、AdoQueryConnection オブジェクト (Access または SQL Server のデータベースからデータを取得するためのデータ接続を表すオブジェクト) で作業するには、次の例で示すように、DataConnectionCollection から返されるオブジェクトをキャストする必要があります。
// Get the Employees connection from the
// DataConnections collection.
AdoQueryConnection myAdoQueryConnection =
(AdoQueryConnection)(this.DataConnections["Employees"]);
' Get the Employees connection from the
' DataConnections collection.
Dim myAdoQueryConnection As AdoQueryConnection = _
DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)
データ接続の使い方の詳細については、「[方法] 外部データ ソースにアクセスする方法」を参照してください。
スレッドの安全性
この型の public static (Visual Basic ではShared ) メンバーはスレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。