SharepointListQueryConnection クラス
メモ: この API は現在は使用されていません。
SharePoint リストまたはドキュメント ライブラリからデータを取得するためのデータ接続を表します。
継承階層
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SharepointListQueryConnection
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
<ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")> _
Public MustInherit Class SharepointListQueryConnection _
Inherits DataConnection
'使用
Dim instance As SharepointListQueryConnection
[ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : DataConnection
解説
重要
SharepointListQueryConnection クラスおよびそのメンバーは Microsoft InfoPath 2010 では現在使用されていません。このクラスのメンバーで書かれたコードは、InfoPath 2003 または InfoPath 2007 で作成された SharePoint ドキュメント ライブラリへのデータ接続、InfoPath 2010 で [InfoPath 2007 フォーム テンプレート] の 1 つを使用して作成された新しいフォーム テンプレートでのデータ接続、または [データ接続] ダイアログ ボックスの [以前のバージョンに変換] ボタンを使用して変換されたデータ接続のみと互換性があります。InfoPath 2010 フォーム テンプレートで作成された SharePoint ドキュメント ライブラリへのデータ接続を使用して動作するコードを書くには、SharePointListRWQueryConnection クラスのメンバーを使用します。また、[データ接続] ダイアログ ボックスの [現在のバージョンに変換] ボタンを使用して SharePoint ドキュメント ライブラリへのデータ接続を変換する場合は、SharepointListQueryConnection クラスのメンバーを使用して書かれたすべてのコードを、代わりに SharePointListRWQueryConnection クラスのメンバーを使用して書き換える必要があります。
SharePointListQueryConnection オブジェクトは、[データ接続ウィザード] を使用して InfoPath で作成されたセカンダリ データ接続を表し、SharePoint リストまたはドキュメント ライブラリからデータを取得するために必要なすべての情報を指定します。
SharePointListQueryConnection クラスが提供するプロパティを使用すると、データ接続の名前や、接続がデータを取得してくる Windows SharePoint Services サイト上のリストまたはドキュメント ライブラリの URL (Uniform Resource Locator) を取得することができます。
データ接続と関連付けられた SharePointListQueryConnection オブジェクトは、XmlForm クラスの DataConnections プロパティを使用してアクセスでき、フォーム テンプレートの DataConnectionCollection から接続を返します。
既定の Execute メソッドは、DataConnection 基本クラスから継承され、InfoPath のフォーム テンプレート デザイン モードで宣言的に定義された値を使用して、クエリや送信処理を実行します。さらに、SharePointListQueryConnection クラスが提供する SharepointListQueryConnection.Execute メソッドを使用すると、返されたデータを挿入する別の場所を指定できます。
SharePointListQueryConnection クラスは、Microsoft Office InfoPath 2003 オブジェクト モデルの SharePointListAdapterObject インターフェイスに対応しています。
例
次の例では、SharePoint 上の連絡先情報の一覧に接続する "Contacts" という名前の接続を表す SharePointListQueryConnection オブジェクトへの参照を、DataConnectionCollection クラスの Item プロパティに名前を渡した後、返されたオブジェクトを SharePointListQueryConnection 型にキャストすることで設定しています。
[C#]
SharePointListQueryConnection spConnection = (SharePointListQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListQueryConnection)
参照が設定された後は、SharePointListQueryConnection オブジェクトのプロパティやメソッドを使用できます。次の例では、DataConnection 基本クラスから継承される Name プロパティによって返される値を、文字列変数に設定しています。
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
スレッドの安全性
この型の public static (Visual Basic ではShared ) メンバーはスレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。