次の方法で共有

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

名前と値のペアを含むデータセットから、指定した名前の最初の一致する値を返します。

注

レポート定義 (.rdl) は、レポート ビルダーと SQL Server Data Tools のレポート デザイナーで作成および変更できます。 作成環境ごとに、レポートと関連アイテムを作成、開く、保存するさまざまな方法が用意されています。 詳細については、Web 上の microsoft.com にある レポート デザイナーおよびレポート ビルダー (SSRS) でのレポートのデザイン を参照してください。

構文

  
Lookup(source_expression, destination_expression, result_expression, dataset)

パラメーター

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

目的地_表現
(Variant) データセット内の各行に対して評価され、一致する名前またはキーを指定する式。 たとえば、=Fields!ProductID.Value のようにします。

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

データセット
レポート内のデータセットの名前を指定する定数。 たとえば、"Products" などです。

帰る

Variantを返します。一致しない場合はNothingを返します。

注釈

Lookupを使用して、1 対 1 のリレーションシップがある名前と値のペアの指定したデータセットから値を取得します。 たとえば、テーブル内の ID フィールドの場合、 Lookup を使用して、データ領域にバインドされていないデータセットから対応する Name フィールドを取得できます。

Lookup は次の処理を行います。

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

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

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

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

1 対多のリレーションシップがある 1 つの名前またはキー フィールドに対して複数の値を取得するには、 LookupSet 関数 (レポート ビルダーおよび SSRS) を使用します。 一連の値の Lookup を呼び出すには、 Multilookup 関数 (レポート ビルダーおよび SSRS) を使用します。

次の制限が適用されます。

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

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

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

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

  • Lookup は、次のレポート アイテムの式として使用できません。

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

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

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

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

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

    • Report.Language プロパティ。

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

例

次の例では、製品識別子 ProductID のフィールドを含むデータセットにテーブルがバインドされているとします。 "Product" という別のデータセットには、対応する製品識別子 ID と製品名名が含まれています。

次の式では、 Lookup は ProductID の値を "Product" というデータセットの各行の ID と比較し、一致が見つかった場合は、その行の Name フィールドの値を返します。

=Lookup(Fields!ProductID.Value, Fields!ID.Value, Fields!Name.Value, "Product")

こちらもご覧ください

レポートでの式の使用 (レポート ビルダーおよび SSRS)
式の例 (レポート ビルダーおよび SSRS)
式で使用されるデータ型 (レポート ビルダーおよび SSRS)
合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)

  • Last updated on