Nachschlagefunktion (Berichts-Generator und SSRS)

Gibt den ersten übereinstimmenden Wert für den angegebenen Namen aus einem Dataset zurück, das Name/Wert-Paare enthält.

Syntax

  
Lookup(source_expression, destination_expression, result_expression, dataset)  

Die Parameter

source_expression
(Variant) Ein Ausdruck, der im aktuellen Bereich ausgewertet wird und den Namen oder Schlüssel angibt, der nachgeschlagen werden soll. Beispiel: =Fields!ProdID.Value.

destination_expression
(Variant) Ein Ausdruck, der für jede Zeile in einem Dataset ausgewertet wird und den Namen oder Schlüssel angibt, mit dem eine Übereinstimmung erzielt werden soll. Beispiel: =Fields!ProductID.Value.

result_expression
(Variant) Ein Ausdruck, der für die Zeile im Dataset ausgewertet wird, wo source_expression = destination_expression gleich ist und der den abzurufenden Wert angibt. Beispiel: =Fields!ProductName.Value.

Dataset
Eine Konstante, die den Namen eines Datasets im Bericht angibt. Beispiel: "Produkte".

Rückkehr

Gibt ein Variant, oder Nothing wenn keine Übereinstimmung vorhanden ist.

Bemerkungen

Verwenden Sie Lookup, um den Wert aus dem spezifizierten Dataset für ein Name-Wert-Paar abzurufen, bei dem eine 1:1-Beziehung besteht. Beispielsweise können Sie für ein ID-Feld in einer Tabelle Lookup verwenden, um das entsprechende Feld "Name" aus einem Dataset abzurufen, das nicht an den Datenbereich gebunden ist.

Lookup führt die folgenden Aktionen aus:

• Der Quellausdruck wird im aktuellen Bereich ausgewertet.

• Der Zielausdruck wird für jede Zeile des angegebenen Datasets ausgewertet, nachdem Filter angewendet wurden, und zwar anhand der Sortierung des angegebenen Datasets.

• Bei der ersten Übereinstimmung von Quellausdruck und Zielausdruck wird der Ergebnisausdruck für diese Zeile im Dataset ausgewertet.

• Der Ergebnisausdruckswert wird zurückgegeben.

Wenn Sie mehrere Werte für ein einzelnes Namens- oder Schlüsselfeld abrufen möchten, bei dem eine 1:n-Beziehung vorhanden ist, verwenden Sie LookupSet-Funktion (Berichts-Generator und SSRS). Verwenden Sie die Multilookup-Funktion (Berichts-Generator und SSRS), um eine Reihe von Werten aufzurufenLookup.

Es gelten die folgenden Einschränkungen:

• Lookup wird ausgewertet, nachdem alle Filterausdrücke angewendet wurden.

• Nur eine Suchebene wird unterstützt. Ein Quell-, Ziel- oder Ergebnisausdruck kann keinen Verweis auf eine Suchfunktion einschließen.

• Quell- und Zielausdrücke müssen den gleichen Datentyp ergeben. Der Rückgabetyp ist der gleiche wie der Datentyp des ausgewerteten Ergebnisausdrucks.

• Quell-, Ziel- und Ergebnisausdrücke können keine Verweise auf Berichts- oder Gruppenvariablen einschließen.

• Lookup Kann nicht als Ausdruck für die folgenden Berichtselemente verwendet werden:

  • Dynamische Verbindungszeichenfolgen für eine Datenquelle.

  • Berechnete Felder in einem Dataset.

  • Abfrageparameter in einem Dataset.

  • Filter in einem Dataset.

  • Berichtsparameter.

  • Die Eigenschaft „Report.Language“.

Weitere Informationen finden Sie in der Aggregatfunktionsreferenz (Berichts-Generator und SSRS) und unter Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS).

Beispiel

Gehen Sie im folgenden Beispiel davon aus, dass eine Tabelle an ein Dataset gebunden ist, das ein Feld für die Produkt-ID "ProductID" enthält. Ein separates Dataset namens "Product" enthält die entsprechende Produkt-ID und den Produktnamen.

Im folgenden Ausdruck Lookup wird der Wert von "ProductID" mit der ID in jeder Zeile des Datasets mit dem Namen "Product" verglichen, und wenn eine Übereinstimmung gefunden wird, wird der Wert des Felds "Name" für diese Zeile zurückgegeben.

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

Siehe auch

Ausdrucksverwendungen in Berichten (Berichts-Generator und SSRS)
Beispiele für Ausdrücke (Berichts-Generator und SSRS)
Datentypen in Ausdrücken (Berichts-Generator und SSRS)
Ausdrucksbereich für Gesamtwerte, Aggregate und integrierte Auflistungen (Berichts-Generator und SSRS)