Clausola Join (Visual Basic)Join Clause (Visual Basic)

Combina due raccolte in un'unica raccolta.Combines two collections into a single collection. L'operazione di join è basata sulle chiavi corrispondenti e usa l'operatore Equals.The join operation is based on matching keys and uses the Equals operator.

SintassiSyntax

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

PartiParts

element Obbligatorio.element Required. Variabile di controllo per la raccolta da unire in join.The control variable for the collection being joined.

collection
Obbligatorio.Required. Raccolta da combinare con la raccolta identificata sul lato sinistro dell'operatore di Join.The collection to combine with the collection identified on the left side of the Join operator. Una clausola Join può essere annidata in un'altra clausola Join o in una clausola Group Join.A Join clause can be nested in another Join clause, or in a Group Join clause.

joinClause
Parametro facoltativo.Optional. Una o più clausole Join aggiuntive per perfezionare ulteriormente la query.One or more additional Join clauses to further refine the query.

groupJoinClause
Parametro facoltativo.Optional. Una o più clausole Group Join aggiuntive per perfezionare ulteriormente la query.One or more additional Group Join clauses to further refine the query.

key1 Equals key2key1 Equals key2
Obbligatorio.Required. Identifica le chiavi per le raccolte da unire in join.Identifies keys for the collections being joined. È necessario utilizzare l'operatore Equals per confrontare le chiavi delle raccolte da unire in join.You must use the Equals operator to compare keys from the collections being joined. È possibile combinare le condizioni di join usando l'operatore And per identificare più chiavi.You can combine join conditions by using the And operator to identify multiple keys. key1 deve provenire dalla raccolta sul lato sinistro dell'operatore Join.key1 must be from the collection on the left side of the Join operator. key2 deve provenire dalla raccolta sul lato destro dell'operatore Join.key2 must be from the collection on the right side of the Join operator.

Le chiavi utilizzate nella condizione di join possono essere espressioni che includono più di un elemento della raccolta.The keys used in the join condition can be expressions that include more than one item from the collection. Ogni espressione chiave può tuttavia contenere solo elementi della rispettiva raccolta.However, each key expression can contain only items from its respective collection.

NoteRemarks

La clausola Join combina due raccolte in base ai valori di chiave corrispondenti delle raccolte da unire in join.The Join clause combines two collections based on matching key values from the collections being joined. La raccolta risultante può contenere qualsiasi combinazione di valori della raccolta identificata sul lato sinistro dell'operatore Join e della raccolta identificata nella clausola 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 query restituirà solo i risultati per i quali viene soddisfatta la condizione specificata dall'operatore Equals.The query will return only results for which the condition specified by the Equals operator is met. Equivale a un INNER JOIN in SQL.This is equivalent to an INNER JOIN in SQL.

È possibile utilizzare più clausole Join in una query per unire due o più raccolte in una singola raccolta.You can use multiple Join clauses in a query to join two or more collections into a single collection.

È possibile eseguire un join implicito per combinare raccolte senza la clausola Join.You can perform an implicit join to combine collections without the Join clause. A tale scopo, includere più clausole In nella clausola From e specificare una clausola Where che identifichi le chiavi che si desidera utilizzare per il join.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.

È possibile usare la clausola Group Join per combinare le raccolte in un'unica raccolta gerarchica.You can use the Group Join clause to combine collections into a single hierarchical collection. Questa operazione è simile a una LEFT OUTER JOIN in SQL.This is like a LEFT OUTER JOIN in SQL.

EsempioExample

Nell'esempio di codice seguente viene eseguito un join implicito per combinare un elenco di clienti con i relativi ordini.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

EsempioExample

L'esempio di codice seguente unisce due raccolte usando la clausola 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

In questo esempio verrà generato un output simile al seguente:This example will produce output similar to the following:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

EsempioExample

Nell'esempio di codice seguente vengono unite due raccolte utilizzando la clausola Join con due colonne chiave.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

Nell'esempio viene generato un output simile al seguente: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

Vedere ancheSee also