Csatlakozási záradék (Visual Basic)

Cikk
03/05/2024

Két gyűjteményt egyesít egyetlen gyűjteménybe. Az illesztési művelet egyező kulcsokon alapul, és az operátort Equals használja.

Syntax

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

Részek

element Szükséges. Az összekapcsolt gyűjtemény vezérlőváltozója.

collection
Szükséges. Az operátor bal oldalán Join azonosított gyűjteményrel kombinálandó gyűjtemény. A Join záradékok beágyazhatók egy másik Join záradékba vagy egy Group Join záradékba.

joinClause
Opcionális. Egy vagy több további Join záradék a lekérdezés további finomításához.

groupJoinClause
Opcionális. Egy vagy több további Group Join záradék a lekérdezés további finomításához.

key1 Equals key2
Szükséges. Azonosítja az összekapcsolt gyűjtemények kulcsait. Az operátorral Equals össze kell hasonlítania a csatlakoztatott gyűjtemények kulcsait. Összekapcsolási feltételeket kombinálhat az And operátorral több kulcs azonosításához. key1 az operátor bal oldalán található gyűjteményből kell származnia Join . key2 az operátor jobb oldalán található gyűjteményből kell származnia Join .

Az illesztési feltételben használt kulcsok olyan kifejezések lehetnek, amelyek egynél több elemet tartalmaznak a gyűjteményből. Az egyes kulcskifejezések azonban csak a saját gyűjteményéből származó elemeket tartalmazhatnak.

Megjegyzések

A Join záradék két gyűjteményt egyesít az összekapcsolt gyűjtemények kulcsértékeinek megfelelő alapján. Az eredményként kapott gyűjtemény az operátor bal oldalán Join azonosított gyűjtemény és a záradékban Join azonosított gyűjtemény értékeinek bármilyen kombinációját tartalmazhatja. A lekérdezés csak azokat az eredményeket adja vissza, amelyek esetében az Equals operátor által megadott feltétel teljesül. Ez egyenértékű az INNER JOIN SQL-ben.

Egy lekérdezésben több Join záradékot is használhat két vagy több gyűjtemény egyetlen gyűjteményhez való csatlakoztatásához.

Implicit illesztést is végrehajthat a gyűjtemények záradék nélküli Join egyesítése érdekében. Ehhez vegyen fel több In záradékot a From záradékba, és adjon meg egy záradékot Where , amely azonosítja az illesztéshez használni kívánt kulcsokat.

A Group Join záradék használatával a gyűjtemények egyetlen hierarchikus gyűjteménybe egyesíthetők. Ez olyan, mint egy LEFT OUTER JOIN SQL-ben.

1. példa

Az alábbi példakód implicit illesztéssel kombinálja az ügyfelek listáját a rendelésekkel.

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

2. példa

Az alábbi példakód két gyűjteményt illeszt össze a Join záradék használatával.

Imports System.Diagnostics

Public Class JoinSample

    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

Ez a példa a következőhöz hasonló kimenetet eredményez:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

3. példa

Az alábbi példakód két gyűjteményt illeszt össze a záradék és két Join kulcsoszlop használatával.

Imports System.Diagnostics

Public Class JoinSample2

    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

A példa a következőhöz hasonló kimenetet hoz létre:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8