Предложение Join (Visual Basic)Join Clause (Visual Basic)

Объединяет две коллекции в одну.Combines two collections into a single collection. Операция Join основана на совпадающих ключах и использует Equals оператор.The join operation is based on matching keys and uses the Equals operator.

СинтаксисSyntax

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

КомпонентыParts

element Обязательный.element Required. Управляющая переменная для объединяемой коллекции.The control variable for the collection being joined.

collection
Обязательный элемент.Required. Коллекция для объединения с коллекцией, указанной в левой части Join оператора.The collection to combine with the collection identified on the left side of the Join operator. JoinПредложение может быть вложенным в другое Join предложение или в Group Join предложении.A Join clause can be nested in another Join clause, or in a Group Join clause.

joinClause
Необязательный элемент.Optional. Одно или несколько дополнительных Join предложений для дальнейшего уточнения запроса.One or more additional Join clauses to further refine the query.

groupJoinClause
Необязательный элемент.Optional. Одно или несколько дополнительных Group Join предложений для дальнейшего уточнения запроса.One or more additional Group Join clauses to further refine the query.

key1 Equals key2key1 Equals key2
Обязательный элемент.Required. Определяет ключи для соединяемых коллекций.Identifies keys for the collections being joined. EqualsДля сравнения ключей из объединяемых коллекций необходимо использовать оператор.You must use the Equals operator to compare keys from the collections being joined. Условия объединения можно комбинировать с помощью And оператора для обнаружения нескольких ключей.You can combine join conditions by using the And operator to identify multiple keys. key1 должен быть из коллекции в левой части Join оператора.key1 must be from the collection on the left side of the Join operator. key2 должен находиться в коллекции с правой стороны Join оператора.key2 must be from the collection on the right side of the Join operator.

Ключи, используемые в условии объединения, могут быть выражениями, включающими более одного элемента из коллекции.The keys used in the join condition can be expressions that include more than one item from the collection. Однако каждое ключевое выражение может содержать только элементы из соответствующей коллекции.However, each key expression can contain only items from its respective collection.

RemarksRemarks

JoinПредложение объединяет две коллекции на основе совпадающих значений ключей из объединяемых коллекций.The Join clause combines two collections based on matching key values from the collections being joined. Результирующая коллекция может содержать любое сочетание значений из коллекции, указанной в левой части Join оператора, и коллекции, указанной в 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. Запрос возвратит только результаты, для которых выполняется условие, заданное Equals оператором.The query will return only results for which the condition specified by the Equals operator is met. Это эквивалентно INNER JOIN в SQL.This is equivalent to an INNER JOIN in SQL.

JoinДля объединения двух или более коллекций в одну коллекцию можно использовать несколько предложений в запросе.You can use multiple Join clauses in a query to join two or more collections into a single collection.

Можно выполнить неявное соединение для объединения коллекций без Join предложения.You can perform an implicit join to combine collections without the Join clause. Для этого включите In в предложение несколько предложений From и укажите Where предложение, определяющее ключи, которые необходимо использовать для объединения.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.

Предложение можно использовать Group Join для объединения коллекций в одну иерархическую коллекцию.You can use the Group Join clause to combine collections into a single hierarchical collection. Это похоже на LEFT OUTER JOIN в SQL.This is like a LEFT OUTER JOIN in SQL.

ПримерExample

В следующем примере кода выполняется неявное соединение для объединения списка клиентов с их заказами.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

ПримерExample

В следующем примере кода две коллекции объединяются с помощью 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

В этом примере выводятся выходные данные, аналогичные приведенным ниже.This example will produce output similar to the following:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

ПримерExample

В следующем примере кода две коллекции соединяются с помощью Join предложения с двумя ключевыми столбцами.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

В примере будет выведен результат, аналогичный приведенному ниже: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

См. такжеSee also