Funkcja Lookup (program Report Builder 3.0 i usługi SSRS)

Zwraca pierwszą pasującą wartość dla określonej nazwy z zestawu danych zawierającego pary nazwa/wartość.

Ostrzeżenie

Program Business Intelligence Development Studio umożliwia tworzenie i modyfikowanie definicji raportów (rdl) przy użyciu programów Report Builder 3.0 i Report Designer. Każde ze środowisk obsługuje różne sposoby tworzenia, otwierania i zapisywania raportów oraz powiązanych z nimi elementów. Aby uzyskać więcej informacji, zobacz temat Projektowanie raportów w programach Report Designer i Report Builder 3.0 (usługi SSRS) w witrynie sieci Web microsoft.com.

Składnia

Lookup(source_expression, destination_expression, result_expression, dataset)

Parametry

  • source_expression
    (Variant) Wyrażenie jest oceniane w bieżącym zakres , określające nazwę lub klucz wyszukiwania up.Na przykład =Fields!ProdID.Value.

  • destination_expression
    (Variant) Wyrażenie, które jest obliczane dla każdego wiersza w dataset i określa nazwę lub klucz do zgodne na.Na przykład =Fields!ProductID.Value.

  • result_expression
    (Variant) Wyrażenie obliczane dla wierszy w zestawie danych gdzie source_expression = destination_expression, i która określa wartość do pobrania.Na przykład =Fields!ProductName.Value.

  • dataset
    Stała określająca nazwę zestawu danych w raporcie.Na przykład: „Produkty”.

Zwracane wartości

Zwraca Variant, lub Nothing , jeśli nie ma żadnego dopasowania.

Uwagi

Użyj Lookup , aby pobrać wartość dataset określony dla pary nazwa/wartość w przypadku, gdy nie ma relacji 1-do-1.Na przykład dla ID pole w tabela, można użyć Lookup pobrać odpowiednie Name pole z zestawu danych, która nie jest związana z danymi region.

Lookup wykonuje następujące czynności:

  • Oblicza wyrażenie źródłowe w bieżącym zakresie.

  • Oblicza wyrażenie docelowe dla każdego wiersza określonego zestawu danych po zastosowaniu filtrów, na podstawie sortowania określonego zestawu danych.

  • W przypadku pierwszego dopasowania wyrażenia źródłowego i wyrażenia docelowego oblicza wyrażenie wynikowe dla danego wiersza w zestawie danych.

  • Zwraca wartość wyrażenia wynikowego.

Aby pobrać wiele wartości dla jednej nazwy lub pole klucz w przypadku relacji jeden-do wielu, należy użyć Funkcja LookupSet (program Report Builder 3.0 i usługi SSRS).Wywołanie Lookup dla zestaw wartości, użyj Funkcja Multilookup (program Report Builder 3.0 i usługi SSRS).

Obowiązują następujące ograniczenia:

  • Funkcja Lookup jest wykonywana po zastosowaniu wszystkich wyrażeń filtru.

  • Obsługiwany jest tylko jeden poziom wyszukiwania.Wyrażenie źródłowe, docelowe ani wynikowe nie może zawierać odwołania do funkcji wyszukiwania.

  • Wartości wyrażeń źródłowego i docelowego muszą być tego samego typu.Typ zwracany jest taki sam jak typ danych obliczonego wyrażenia wynikowego.

  • Wyrażenie źródłowe, docelowe ani wynikowe nie może zawierać odwołań do zmiennych raportów ani grup.

  • Lookup nie można używać jako wyrażenie dla następujących elementów raportu:

    • Dynamiczne parametry połączenia ze źródłem danych.

    • Pola obliczeniowe w zestawie danych.

    • Parametry zapytania w zestawie danych.

    • Filtry w zestawie danych.

    • Parametry raportu.

    • Report.Language właściwość.

Aby uzyskać więcej informacji, zobacz Kompendium funkcji agregujących (program Report Builder 3.0 i usługi SSRS) i Opis zakresu wyrażeń dla sum, wartości zagregowanych i kolekcji wbudowanych (program Report Builder 3.0 i usługi SSRS).

Przykład

W poniższym przykładzie założono, że tabela jest powiązana DataSet, który zawiera pole identyfikatora produktu ProductID.Oddzielnych zestawów danych, nazywane "Produkt" zawiera odpowiedni identyfikator produktu ID i nazwa produktu Name.

W następującej wyrażenie, Lookup porównuje wartość ProductID do ID w każdym wierszu zestawu danych o nazwie "Produkt" a gdy zostanie znaleziony, zwraca wartość Name pole dla tego wiersza.

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