CSharp Keyword on

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C#: on

Довідник C# · Практичне керівництво

Вказує лівий ключ LINQ join перед equals.

Простий приклад (Example.cs)

Збережіть цей приклад окремо як Example.cs. Запускайте його незалежно від інших прикладів на сторінці.

Example.cs:

// PROJECT-EXAMPLE
using System.Linq;
int[] values = [1, 2, 3];
var result = from n in values join other in new[] { 2 } on n equals other select n;
System.Console.WriteLine(string.Join(",", result));

Результат:

2

Синтаксис

join ... on leftKey equals rightKey

Запит зазвичай виконується відкладено під час перебору. ToArray/ToList фіксує результат у новій колекції.

Приклад 1: базова форма

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        var items = new[] { new { Id = 1, Name = "ore" }, new { Id = 2, Name = "wood" } };
        var counts = new[] { new { Id = 1, Count = 4 }, new { Id = 2, Count = 2 } };
        var query = from item in items
                    join count in counts on item.Id equals count.Id
                    let total = count.Count * 2
                    where total > 3
                    orderby total descending, item.Name ascending
                    select new { item.Name, Total = total };
        foreach (var item in query) Console.WriteLine($"{item.Name}:{item.Total}");
    }
}

Приклад 2: інша практична форма

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        var owners = new[] { new { Id = 1, Name = "A" }, new { Id = 2, Name = "B" } };
        var items = new[] { new { OwnerId = 1, Name = "ore" } };
        var query = from owner in owners
                    join item in items on owner.Id equals item.OwnerId into owned
                    from item in owned.DefaultIfEmpty()
                    select $"{owner.Name}:{item?.Name ?? "empty"}";
        foreach (string text in query) Console.WriteLine(text);
    }
}

Офіційне джерело: Microsoft Learn.