Join – klauzule (Visual Basic)Join Clause (Visual Basic)

Kombinuje dvě kolekce do jedné kolekce.Combines two collections into a single collection. Operace JOIN je založena na porovnávacích klíčích a používá Equals operátor.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 [... ]

SoučástiParts

elementPožadovanou.element Required. Řídicí proměnná pro kolekci, která je připojena.The control variable for the collection being joined.

collection
Povinná hodnota.Required. Kolekce, která se má zkombinovat s kolekcí identifikovanou na levé straně Join operátoru.The collection to combine with the collection identified on the left side of the Join operator. JoinKlauzule může být vnořena do jiné Join klauzule nebo v Group Join klauzuli.A Join clause can be nested in another Join clause, or in a Group Join clause.

joinClause
Nepovinný parametr.Optional. Jedna nebo více dalších Join klauzulí pro další upřesnění dotazu.One or more additional Join clauses to further refine the query.

groupJoinClause
Nepovinný parametr.Optional. Jedna nebo více dalších Group Join klauzulí pro další upřesnění dotazu.One or more additional Group Join clauses to further refine the query.

key1 Equals key2key1 Equals key2
Povinná hodnota.Required. Identifikuje klíče pro připojené kolekce.Identifies keys for the collections being joined. EqualsK porovnání klíčů z kolekcí, které jsou spojeny, je nutné použít operátor.You must use the Equals operator to compare keys from the collections being joined. Podmínky spojení můžete kombinovat pomocí And operátora k identifikaci více klíčů.You can combine join conditions by using the And operator to identify multiple keys. key1musí být z kolekce na levé straně Join operátoru.key1 must be from the collection on the left side of the Join operator. key2musí být z kolekce na pravé straně Join operátoru.key2 must be from the collection on the right side of the Join operator.

Klíče používané v podmínce spojení mohou být výrazy, které obsahují více než jednu položku z kolekce.The keys used in the join condition can be expressions that include more than one item from the collection. Každý klíčový výraz však může obsahovat pouze položky z příslušné kolekce.However, each key expression can contain only items from its respective collection.

PoznámkyRemarks

JoinKlauzule kombinuje dvě kolekce na základě porovnání hodnot klíčů z připojených kolekcí.The Join clause combines two collections based on matching key values from the collections being joined. Výsledná kolekce může obsahovat libovolnou kombinaci hodnot z kolekce identifikované na levé straně Join operátoru a kolekce identifikované v Join klauzuli.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. Dotaz vrátí pouze výsledky, pro které Equals je splněna podmínka určená operátorem.The query will return only results for which the condition specified by the Equals operator is met. To je ekvivalentem INNER JOIN v SQL.This is equivalent to an INNER JOIN in SQL.

V dotazu můžete použít více Join klauzulí k propojení dvou nebo více kolekcí do jedné kolekce.You can use multiple Join clauses in a query to join two or more collections into a single collection.

Můžete provést implicitní spojení pro kombinování kolekcí bez Join klauzule.You can perform an implicit join to combine collections without the Join clause. Provedete to tak, In že zahrnete do své klauzule více klauzulí From a zadáte Where klauzuli, která identifikuje klíče, které chcete použít pro spojení.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.

Klauzuli můžete použít Group Join ke kombinování kolekcí do jedné hierarchické kolekce.You can use the Group Join clause to combine collections into a single hierarchical collection. To se podobá LEFT OUTER JOIN v SQL.This is like a LEFT OUTER JOIN in SQL.

PříkladExample

Následující příklad kódu provede implicitní spojení a kombinuje seznam zákazníků se svými objednávkami.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

PříkladExample

Následující příklad kódu spojuje dvě kolekce pomocí Join klauzule.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

Tento příklad vytvoří výstup podobný následujícímu:This example will produce output similar to the following:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

PříkladExample

Následující příklad kódu spojuje dvě kolekce pomocí Join klauzule se dvěma klíčovými sloupci.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

Příklad vytvoří výstup podobný následujícímu: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

Viz takéSee also