XmlForm.QueryDataConnection プロパティ
フォームに関連付けられたデータ接続を表す DataConnection オブジェクトへの参照を取得します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (microsoft.office.infopath.dll 内)
構文
'宣言
Public MustOverride ReadOnly Property QueryDataConnection As DataConnection
'使用
Dim instance As XmlForm
Dim value As DataConnection
value = instance.QueryDataConnection
public abstract DataConnection QueryDataConnection { get; }
プロパティ値
フォームに関連付けられたデータ接続を表す DataConnection です。
コメント
DataConnection オブジェクトは、データを取得して外部データ ソースに送信するプロパティとメソッドを提供します。フォームに関連付けられたデータ接続は、フォームが最初に作成されたときに使用されたデータ ソースの型に依存します。
QueryDataConnection プロパティを使用すると、InfoPath フォームのプライマリ データ ソースにアクセスできます。フォームのセカンダリ データ ソースに使用されているデータ アダプタ オブジェクトにアクセスするには、DataSources プロパティを使用します。
.gif "メモ") メモ : |
|---|
QueryDataConnection プロパティは、COM/スクリプト オブジェクト モデルにおける XDocument オブジェクトの QueryAdapter プロパティ、および InfoPath 2003 互換マネージ コード オブジェクト モデルにおける _XDocument2 インターフェイスの QueryAdapter プロパティと同様の機能を提供します。 |
このメンバは、現在開いているフォームと同じドメイン内で実行されているフォーム、またはドメインを越えたアクセス許可を付与されているフォームだけがアクセスできます。
この型またはメンバは、Microsoft Office InfoPath 2007 または Web ブラウザで開いているフォームで実行されているコードからのみアクセスできます。
例
次の例では、XmlForm クラスの QueryDataConnection プロパティを使用して、フォーム テンプレートに関連付けられた ADOQueryConnection および ADOSubmitConnection オブジェクトへの参照を設定します。次に、ADOQueryConnection オブジェクトの Command プロパティと ADOQueryConnection オブジェクトの Command プロパティを使用して、それぞれの接続の種類に応じた SQL コマンド テキストをメッセージ ボックスに表示します。
ADOQueryConnection queryConnection;
ADOSubmitConnection submitConnection;
queryConnection = (ADOQueryConnection) this.QueryConnection;
MessageBox.Show("Query SQL command text: " + queryConnection.Command);
submitConnection = (ADOSubmitConnection) this.QueryConnection;
MessageBox.Show("Submit SQL command text: " + querySubmit.Command);
Dim queryConnection As ADOQueryConnection
Dim submitConnectionmAs ADOSubmitConnection
queryConnection = DirectCast(ADOQueryConnection, Me.QueryConnection)
MessageBox.Show("Query SQL command text: " & queryConnection.Command)
submitConnection = DirectCast(ADOSubmitConnection, Me.QueryConnection)
MessageBox.Show("Submit SQL command text: " & querySubmit.Command)