Report Builder 関数 - ページ割り付けレポートの Lookup 関数 (Report Builder)
適用対象: 
Microsoft レポート ビルダー (SSRS) Power BI Report Builder SQL Server Data Tools のレポート デザイナー
Lookup は、ページ割り付けレポートの名前と値のペアを含むデータセットから、指定された名前に一致する最初の値を返します。
Note
ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。
構文
Lookup(source_expression, destination_expression, result_expression, dataset)
Parameters
| パラメーター | 定義 |
|---|---|
| source_expression | (Variant) 現在のスコープ内で評価し、参照する名前またはキーを指定する式。 たとえば、=Fields!ProdID.Value のようにします。 |
| destination_expression | (Variant) データセット内の各行に対して評価し、照合する名前またはキーを指定する式。 たとえば、=Fields!ProductID.Value のようにします。 |
| result_expression | (Variant) source_expression = destination_expression であるデータセットの行で評価し、取得する値を指定する式。 たとえば、=Fields!ProductName.Value のようにします。 |
| データセット (dataset) | レポート内のデータセットの名前を指定する定数。 "Products" は、使用するデータセットの例です。 |
Return
LOOKUP は バリアント を返し、そうしなければ、一致する結果がない場合 Nothing が返されます。
解説
指定したデータセットで、名前と値のペアについて 1 対 1 のリレーションシップが存在する場合、 Lookup を使用して値を取得します。 たとえば、テーブル内の ID フィールドに対して Lookup を使用して、データ領域にバインドされていないデータセットから対応する 名前 フィールドを取得することができます。
Lookup を実行すると、次の処理が行われます。
ソースの式を現在のスコープ内で評価します。
フィルターを適用した後で、指定されたデータセットの照合順序に基づき、指定されたデータセットの各行に対して変換先の式を評価します。
変換元の式と変換先の式が最初に一致したときに、データセット内のその行に対して結果式を評価します。
結果式の値を返します。
1 対多のリレーションシップがある場合、1 つの名前フィールドまたはキー フィールドに対応する複数の値を取得するには、Report Builder 関数 - ページ割り付けレポートの LookupSet 関数 (Report Builder) を使用します。 値のセットについて Lookup を呼び出すには、Report Builder 関数 - ページ割り付けレポートの Multilookup 関数 (Report Builder) を使用します。
次の制限事項が適用されます。
Lookup は、すべてのフィルター式が適用された後で評価されます。
1 レベルの参照のみがサポートされます。 変換元、変換先、または結果の式に、Lookup 関数への参照を含めることはできません。
変換元および変換先の式は、同じデータ型として評価される必要があります。 戻り値の型は、評価された結果式のデータ型と同じです。
変換元、変換先、結果の式には、レポート変数またはグループ変数への参照を含めることができません。
Lookup は、次のレポート アイテムを求める式として使用することはできません。
データ ソースの動的な接続文字列。
データセット内の計算フィールド。
データセット内のクエリ パラメーター。
データセット内のフィルター。
レポート パラメーター。
Report.Language プロパティ。
詳細については、「Report Builder 関数 - ページ割り付けレポートの集計関数リファレンス (Report Builder)」および「ページ割り付けレポートでの合計、集計、組み込みコレクションの式のスコープ (Report Builder)」を参照してください。
例
次の例では、製品の識別子である ProductID のフィールドを含むデータセットにテーブルがバインドされているとします。 別のデータセットである "Product" には、対応する商品 ID と、製品名が含まれています。
次の式では、Lookup を使用して "Product" データセットの各行に含まれる ID と ProductID の値を比較し、一致が見つかった場合には、その行の Name フィールドの値を返します。
=Lookup(Fields!ProductID.Value, Fields!ID.Value, Fields!Name.Value, "Product")