LookupSet 関数 (レポート ビルダー 3.0 および SSRS)

構文

LookupSet(source_expression, destination_expression, result_expression, dataset)

パラメーター

• source_expression
  (Variant) 現在のスコープ内で評価される式。検索する名前またはキーを指定します。たとえば、=Fields!ID.Value のように指定します。

• destination_expression
  (Variant) データセット内の各行に対して評価される式。照合する名前またはキーを指定します。たとえば、=Fields!CustomerID.Value のように指定します。

• result_expression
  (Variant) source_expression が destination_expression と同一であるデータセット内の各行に対して評価される式。取得する値を指定します。たとえば、=Fields!PhoneNumber.Value のように指定します。

• dataset
  レポート内のデータセットの名前を指定する定数。たとえば、"ContactInformation" のように指定します。

Return

VariantArray を返します。一致する結果がなかった場合は、Nothing を返します。

説明

指定したデータセットで、名前と値のペアについて 1 対多のリレーションシップが存在する場合、LookupSet を使用して一連の値を取得します。たとえば、テーブル内の顧客識別子に対して LookupSet を使用して、データ領域にバインドされていないデータセットから、顧客に関連付けられている電話番号をすべて取得することができます。

LookupSet を実行すると、次の処理が行われます。

• ソースの式を現在のスコープ内で評価します。

• フィルターを適用した後で、指定されたデータセットの照合順序に基づき、指定されたデータセットの各行に対して変換先の式を評価します。

• 変換元の式と変換先の式が一致するたびに、データセット内のその行に対して結果式を評価します。

• 結果式の一連の値を返します。

指定した名前に対応する、名前と値のペアを含むデータセットに 1 対 1 のリレーションシップが存在する場合、このデータセットから 1 つの値を取得するには、Lookup 関数 (レポート ビルダー 3.0 および SSRS) を使用します。一連の値に対して Lookup を呼び出すには、Multilookup 関数 (レポート ビルダー 3.0 および SSRS) を使用します。

次の制限があります。

• LookupSet は、すべてのフィルター式が適用された後で評価されます。

• 1 レベルの参照のみがサポートされます。変換元、変換先、結果の式には、Lookup 関数への参照を含めることはできません。

• 変換元および変換先の式は、同じデータ型として評価される必要があります。

• 変換元、変換先、または結果の式に、レポート変数またはグループ変数への参照を含めることはできません。

• LookupSet は、次のレポート アイテムを求める式として使用することはできません。

  • データ ソースの動的な接続文字列。

  • データセット内の計算フィールド。

  • データセット内のクエリ パラメーター。

  • データセット内のフィルター。

  • レポート パラメーター。

  • Report.Language プロパティ。

詳細については、「集計関数リファレンス (レポート ビルダー 3.0 および SSRS)」および「合計、集計、および組み込みコレクションの式のスコープについて (レポート ビルダー 3.0 および SSRS)」を参照してください。

使用例

次の例では、販売区域の識別子である TerritoryGroupID を含むデータセットにテーブルがバインドされているとします。別のデータセットである "Stores" には、販売区域の全店舗の一覧が含まれ、販売区域識別子 ID と、店舗名を表す StoreName が含まれています。

次の式では、"Stores" という名前のデータセットの各行に対して LookupSet を実行し、TerritoryGroupID の値を ID と比較します。一致するたびに、その行の StoreName フィールドの値が結果セットに追加されます。

=LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores")

LookupSet はオブジェクトのコレクションを返すため、結果式をテキスト ボックスに直接表示することはできません。コレクション内の各オブジェクトの値を文字列として連結することはできます。

一連のオブジェクトから区切り記号付きの文字列を作成するには、Visual Basic 関数である Join を使用します。コンマを区切り記号として使用し、オブジェクトを 1 行に結合します。レンダラーによっては、Visual Basic の改行 (vbCrLF) を区切り記号として使用し、各値を新しい 1 つの行に表示することもできます。

次の式では、テキスト ボックスの Value プロパティとして使用したときに、Join を使用して一覧を作成します。

=Join(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"),",")

数回しか表示されないテキスト ボックスでは、テキスト ボックスの値を表示する HTML を生成するカスタム コードを追加してもよいでしょう。テキスト ボックス内に HTML を生成すると追加の処理が必要になるため、数千回も表示されるようなテキスト ボックスの場合、この方法はお勧めできません。

次の Visual Basic 関数をレポート定義の Code ブロックにコピーします。MakeList では、result_expression で返されたオブジェクト配列を受け取り、HTML タグを使用して、順序指定されないリストを生成します。Length は、オブジェクト配列内の項目数を返します。

Function MakeList(ByVal items As Object()) As String
   If items Is Nothing Then
      Return Nothing
   End If

   Dim builder As System.Text.StringBuilder = 
      New System.Text.StringBuilder()
   builder.Append("<ul>")

   For Each item As Object In items
      builder.Append("<li>")
      builder.Append(item)
   Next
   builder.Append("</ul>")

   Return builder.ToString()
End Function

Function Length(ByVal items as Object()) as Integer
   If items is Nothing Then
      Return 0
   End If
   Return items.Length
End Function

HTML を生成するには、関数を呼び出す必要があります。次の式をテキスト ボックスの Value プロパティに貼り付け、テキストのマークアップの種類を HTML に設定します。詳細については、「HTML をレポートに追加する方法 (レポート ビルダー 3.0 および SSRS)」を参照してください。

=Code.MakeList(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"))

関連項目

参照

概念