Join, clause (Visual Basic)Join Clause (Visual Basic)

Combine deux collections en une collection unique.Combines two collections into a single collection. L’opération de jointure est basée sur les clés correspondantes et utilise l’opérateur Equals.The join operation is based on matching keys and uses the Equals operator.

SyntaxeSyntax

Join element In collection _
  [ joinClause _ ]
  [ groupJoinClause ... _ ]
On key1 Equals key2 [ And key3 Equals key4 [... ]

ComposantsParts

element (obligatoire).element Required. Variable de contrôle pour la collection qui est jointe.The control variable for the collection being joined.

collection
Requis.Required. Collection à combiner à la collection identifiée sur le côté gauche de l’opérateur Join.The collection to combine with the collection identified on the left side of the Join operator. Une clause Join peut être imbriquée dans une autre clause Join ou dans une clause Group Join.A Join clause can be nested in another Join clause, or in a Group Join clause.

joinClause
Ce paramètre est facultatif.Optional. Une ou plusieurs clauses de Join supplémentaires pour affiner la requête.One or more additional Join clauses to further refine the query.

groupJoinClause
Ce paramètre est facultatif.Optional. Une ou plusieurs clauses de Group Join supplémentaires pour affiner la requête.One or more additional Group Join clauses to further refine the query.

key1 Equals key2key1 Equals key2
Requis.Required. Identifie les clés pour les collections qui sont jointes.Identifies keys for the collections being joined. Vous devez utiliser l’opérateur Equals pour comparer les clés des collections qui sont jointes.You must use the Equals operator to compare keys from the collections being joined. Vous pouvez combiner des conditions de jointure à l’aide de l’opérateur And pour identifier plusieurs clés.You can combine join conditions by using the And operator to identify multiple keys. key1 doit provenir de la collection sur le côté gauche de l’opérateur Join.key1 must be from the collection on the left side of the Join operator. key2 doit provenir de la collection sur le côté droit de l’opérateur Join.key2 must be from the collection on the right side of the Join operator.

Les clés utilisées dans la condition de jointure peuvent être des expressions qui incluent plus d’un élément de la collection.The keys used in the join condition can be expressions that include more than one item from the collection. Toutefois, chaque expression de clé peut contenir uniquement des éléments de sa collection respective.However, each key expression can contain only items from its respective collection.

NotesRemarks

La clause Join combine deux collections en fonction des valeurs de clé correspondantes des collections qui sont jointes.The Join clause combines two collections based on matching key values from the collections being joined. La collection résultante peut contenir n’importe quelle combinaison de valeurs de la collection identifiée sur le côté gauche de l’opérateur Join et la collection identifiée dans la clause Join.The resulting collection can contain any combination of values from the collection identified on the left side of the Join operator and the collection identified in the Join clause. La requête retourne uniquement les résultats pour lesquels la condition spécifiée par l’opérateur Equals est remplie.The query will return only results for which the condition specified by the Equals operator is met. Cela équivaut à une INNER JOIN dans SQL.This is equivalent to an INNER JOIN in SQL.

Vous pouvez utiliser plusieurs clauses Join dans une requête pour joindre deux collections ou plus dans une collection unique.You can use multiple Join clauses in a query to join two or more collections into a single collection.

Vous pouvez effectuer une jointure implicite pour combiner des collections sans la clause Join.You can perform an implicit join to combine collections without the Join clause. Pour ce faire, incluez plusieurs clauses In dans votre clause From et spécifiez une clause Where qui identifie les clés que vous souhaitez utiliser pour la jointure.To do this, include multiple In clauses in your From clause and specify a Where clause that identifies the keys that you want to use for the join.

Vous pouvez utiliser la clause Group Join pour combiner des collections dans une collection hiérarchique unique.You can use the Group Join clause to combine collections into a single hierarchical collection. C’est comme un LEFT OUTER JOIN dans SQL.This is like a LEFT OUTER JOIN in SQL.

ExempleExample

L’exemple de code suivant effectue une jointure implicite pour combiner une liste de clients avec leurs commandes.The following code example performs an implicit join to combine a list of customers with their orders.

Dim customerIDs() = {"ALFKI", "VICTE", "BLAUS", "TRAIH"}

Dim customerList = From cust In customers, custID In customerIDs
                   Where cust.CustomerID = custID
                   Select cust.CompanyName

For Each companyName In customerList
  Console.WriteLine(companyName)
Next

ExempleExample

L’exemple de code suivant joint deux collections à l’aide de la clause Join.The following code example joins two collections by using the Join clause.

Imports System.Diagnostics
Imports System.Security.Permissions

Public Class JoinSample

  <SecurityPermission(SecurityAction.Demand)>
  Public Sub ListProcesses()
    Dim processDescriptions As New List(Of ProcessDescription)
    processDescriptions.Add(New ProcessDescription With {
                                .ProcessName = "explorer",
                                .Description = "Windows Explorer"})
    processDescriptions.Add(New ProcessDescription With {
                                .ProcessName = "winlogon",
                                .Description = "Windows Logon"})
    processDescriptions.Add(New ProcessDescription With {
                                .ProcessName = "cmd",
                                .Description = "Command Window"})
    processDescriptions.Add(New ProcessDescription With {
                                .ProcessName = "iexplore",
                                .Description = "Internet Explorer"})

    Dim processes = From proc In Process.GetProcesses
                    Join desc In processDescriptions
                      On proc.ProcessName Equals desc.ProcessName
                    Select proc.ProcessName, proc.Id, desc.Description

    For Each proc In processes
      Console.WriteLine("{0} ({1}), {2}",
                        proc.ProcessName, proc.Id, proc.Description)
    Next
  End Sub

End Class

Public Class ProcessDescription
  Public ProcessName As String
  Public Description As String
End Class

Cet exemple produira une sortie similaire à ce qui suit :This example will produce output similar to the following:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

ExempleExample

L’exemple de code suivant joint deux collections à l’aide de la clause Join avec deux colonnes clés.The following code example joins two collections by using the Join clause with two key columns.

Imports System.Diagnostics
Imports System.Security.Permissions

Public Class JoinSample2

  <SecurityPermission(SecurityAction.Demand)>
  Public Sub ListProcesses()
    Dim processDescriptions As New List(Of ProcessDescription2)

    ' 8 = Normal priority, 13 = High priority
    processDescriptions.Add(New ProcessDescription2 With {
                                .ProcessName = "explorer",
                                .Description = "Windows Explorer",
                                .Priority = 8})
    processDescriptions.Add(New ProcessDescription2 With {
                                .ProcessName = "winlogon",
                                .Description = "Windows Logon",
                                .Priority = 13})
    processDescriptions.Add(New ProcessDescription2 With {
                                .ProcessName = "cmd",
                                .Description = "Command Window",
                                .Priority = 8})
    processDescriptions.Add(New ProcessDescription2 With {
                                .ProcessName = "iexplore",
                                .Description = "Internet Explorer",
                                .Priority = 8})

    Dim processes = From proc In Process.GetProcesses
                    Join desc In processDescriptions
                      On proc.ProcessName Equals desc.ProcessName And 
                         proc.BasePriority Equals desc.Priority
                    Select proc.ProcessName, proc.Id, desc.Description,
                           desc.Priority

    For Each proc In processes
      Console.WriteLine("{0} ({1}), {2}, Priority = {3}",
                        proc.ProcessName,
                        proc.Id,
                        proc.Description,
                        proc.Priority)
    Next
  End Sub

End Class

Public Class ProcessDescription2
  Public ProcessName As String
  Public Description As String
  Public Priority As Integer
End Class

L’exemple produira une sortie similaire à ce qui suit :The example will produce output similar to the following:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8

Voir aussiSee also