Fonction LookupSet
Retourne le jeu de valeurs correspondantes pour le nom spécifié d'un dataset contenant des paires nom/valeur.
Syntaxe
Lookup(source_expression, destination_expression, result_expression, dataset)
Paramètres
source_expression
(Variant) Une expression évaluée dans l'étendue actuelle et qui spécifie le nom ou la clé à rechercher. Par exemple, =Fields!ID.Value.destination_expression
(Variant) Une expression évaluée pour chaque ligne d'un dataset et qui spécifie le nom ou la clé de correspondance. Par exemple, =Fields!CustomerID.Value.result_expression
(Variant) Une expression évaluée pour la ligne du dataset où source_expression = destination_expression, et qui spécifie la valeur à récupérer. Par exemple, =Fields!PhoneNumber.Value.dataset
Constante qui spécifie le nom d'un dataset dans le rapport. Par exemple, « ContactInformation ».
Return
Retourne une valeur VariantArray, ou Nothing si aucune correspondance n'est trouvée.
Notes
Utilisez LookupSet pour récupérer un jeu de valeurs du dataset spécifié pour une paire nom-valeur lorsqu'il existe une relation un à plusieurs. Par exemple, pour un identificateur de client dans une table, vous pouvez utiliser LookupSet pour récupérer tous les numéros de téléphone associés pour ce client à partir d'un dataset qui n'est pas lié à la région de données.
La fonction LookupSet effectue les actions suivantes :
Évalue l'expression source dans l'étendue actuelle.
Évalue l'expression de destination pour chaque ligne du dataset spécifié après avoir appliqué les filtres, en fonction du classement du dataset spécifié.
Pour chaque correspondance des expressions source et de destination, évalue l'expression de résultat pour cette ligne dans le dataset.
Retourne le jeu de valeurs d'expressions de résultat.
Pour récupérer une valeur unique d'un dataset avec des paires nom/valeur pour un nom spécifié lorsqu'il existe une relation un-à-un, utilisez Fonction Lookup. Pour appeler Lookup pour un jeu de valeurs, utilisez Fonction Multilookup.
Les restrictions suivantes s'appliquent :
LookupSet est évalué après que toutes les expressions de filtre ont été appliquées.
Un seul niveau de recherche est pris en charge. Une expression source, destination ou de résultat ne peut pas inclure de référence à une fonction de recherche.
Les expressions source et de destination doivent correspondre au même type de données.
Les expressions source, de destination et de résultat ne peuvent pas inclure de références à des variables de groupe ou de rapport.
LookupSet ne peut pas être utilisé comme expression pour les éléments de rapport suivants :
des chaînes de connexion dynamiques pour une source de données ;
des champs calculés dans un dataset ;
des paramètres de requête dans un dataset ;
des filtres dans un dataset ;
des paramètres de rapport.
la propriété Report.Language.
Exemple
Dans l'exemple suivant, supposons que la table est liée à un dataset qui inclut un identificateur de secteur de vente IDGroupeSecteur. Un dataset séparé appelé « Magasins » contient la liste de tous les magasins dans un secteur et inclut l'identificateur du secteur ID et le nom du magasin NomMagasin.
Dans l'expression suivante, LookupSet compare la valeur TerritoryGroupID à la valeur ID pour chaque ligne du dataset appelé « Magasins ». Pour chaque correspondance, la valeur du champ StoreName pour cette ligne est ajoutée au jeu de résultats.
=LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores")
Étant donné que LookupSet retourne une collection d'objets, vous ne pouvez pas afficher directement l'expression de résultat dans une zone de texte. Vous pouvez concaténer la valeur de chaque objet dans la collection en tant que chaîne.
Utilisez la fonction Visual BasicJoin pour créer une chaîne délimitée à partir d'un jeu d'objets. Utilisez une virgule comme séparateur pour combiner les objets en une ligne unique. Dans certains convertisseurs, vous pouvez utiliser un saut de ligne Visual Basic (vbCrLF) comme séparateur pour répertorier chaque valeur sur une nouvelle ligne.
L'expression suivante, lorsqu'elle est utilisée comme propriété Value pour une zone de texte, utilise Join pour créer une liste.
=Join(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"),",")
Pour les zones de texte qui seront uniquement restituées quelques fois, vous pouvez choisir d'ajouter un code personnalisé pour générer un code HTML permettant d'afficher des valeurs dans une zone de texte. Le code HTML dans une zone de texte requiert un traitement supplémentaire et ne serait donc pas un bon choix pour une zone de texte restituée des milliers de fois.
Copiez les fonctions Visual Basic suivantes vers un bloc Code dans une définition de rapport. MakeList utilise le tableau d'objets retourné dans result_expression pour générer une liste non ordonnée à l'aide de balises HTML. Length retourne le nombre d'éléments dans le tableau d'objets.
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
Pour générer le code HTML, vous devez appeler la fonction. Collez l'expression suivante dans la propriété Value pour la zone de texte et définissez le type de balise pour le texte sur HTML. Pour plus d'informations, consultez Procédure : ajouter du code HTML à un rapport.
=Code.MakeList(LookupSet(Fields!TerritoryGroupID.Value, Fields!ID.Value, Fields!StoreName.Value, "Stores"))
Voir aussi
Référence
Exemples d'expressions (Reporting Services)
Boîte de dialogue Propriétés du dataset, Options
Concepts
Utilisation des types de données dans les expressions (Reporting Services)