方法: Finder メソッドを追加する

[アーティクル]
08/09/2011

ビジネスデータ接続サービスを有効にして、Web パーツまたはリストに含まれるエンティティの一覧を表示するには、Finder メソッドを作成する必要があります。 Finder メソッドは、エンティティインスタンスのコレクションを返す特殊なメソッドです。詳細については、「Business Data Connectivity モデルのデザイン」を参照してください。

Finder メソッドを作成するには

BDC デザイナーで、エンティティを選択します。 Visual Studio の BDC デザイナーにエンティティを追加する方法の詳細については、「方法: モデルにエンティティを追加する」を参照してください。
[表示] メニューの [その他のウィンドウ] をクリックし、[BDC メソッドの詳細] をクリックします。

[BDC メソッドの詳細] ウィンドウが表示されます。 [BDC メソッドの詳細] ウィンドウの詳細については、「BDC モデルのデザインツールの概要」を参照してください。
[BDC メソッドの詳細] ウィンドウの [メソッドの追加] ドロップダウンリストの [Finder メソッドの作成] をクリックします。

メソッド、戻り値パラメーター、および型記述子が追加されます。
エンティティコレクション型記述子として型記述子を構成します。エンティティコレクション型記述子の作成方法の詳細については、「方法: パラメーターの型記述子を定義する」を参照してください。

注意

SpecificFinder メソッドをエンティティに追加した場合、この手順を実行する必要はありません。 Visual Studio では、SpecificFinder メソッドで定義した型記述子が使用されます。
ソリューションエクスプローラーで、そのエンティティ用に生成されたサービスコードファイルを右クリックし、[コードの表示] をクリックします。サービスコードファイルの詳細については、「ビジネスデータ接続モデルの作成」を参照してください。

Finder メソッドにコードを追加します。このコードは次のタスクを実行します。

データソースからデータを取得します。
エンティティの一覧を BDC サービスに返します。

次の例では、SQL Server の AdventureWorks サンプルデータベースのデータを使用して、Contact エンティティのコレクションを返します。

注意

ServerName フィールドの値を、使用するサーバーの名前に置き換えます。

Public Shared Function ReadList() As IEnumerable(Of Contact)
    Const ServerName As String = "MySQLServerName"
    Dim dataContext As AdventureWorksDataContext = _
        New AdventureWorksDataContext("Data Source=" & ServerName & _
            ";Initial Catalog=AdventureWorks;Integrated Security=True")

    Dim Contacts As IEnumerable(Of Contact) = _
        From TempContacts In dataContext.Contacts.Take(20) _
              Select TempContacts
    Return Contacts
End Function

public static IEnumerable<Contact> ReadList()
{
    const string ServerName = "MySQLServerName";
    AdventureWorksDataContext dataContext = new AdventureWorksDataContext
          ("Data Source=" + ServerName + ";" +
           "Initial Catalog=AdventureWorks;Integrated Security=True");

    IEnumerable<Contact> Contacts =
        from contacts in dataContext.Contacts.Take(20)
        select contacts;
    return Contacts;

}