RU CSharp Keyword partial type

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

C#: partial — частковий тип

Справочник C# · Практическое руководство

partial объединяет несколько объявлений одного типа при компиляции. Части должны принадлежать к тому же сборнику и пространству имен и содержать согласованное имя типа. Так можно поделить данные и поведение меж исходными файлами; это несколько отдельных типов.

Простой пример (Example.cs)

Сохраните этот пример отдельно как Example.cs. Запускайте его независимо от остальных примеров страницы.

Example.cs:

// PROJECT-EXAMPLE
System.Console.WriteLine(new Item().Name);
partial class Item { public string Name => GetName(); }
partial class Item { private string GetName() => "Ore"; }

Результат:

Ore

Синтаксис

public partial class Label { }
public partial struct Rectangle { }

Класс с данными и форматированием в разных файлах

Файл Example.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <LangVersion>14.0</LangVersion>
    <Nullable>enable</Nullable>
    
  </PropertyGroup>

</Project>

Файл Program.cs:

using System;
internal static class Program
{
    public static void Main()
    {
        var label = new Label { Name = "Sensor", Number = 12 };
        Console.WriteLine(label.Format());
    }
}

Файл Label.Data.cs:

public partial class Label
{
    public string Name { get; init; } = "";
    public int Number { get; init; }
}

Файл Label.Display.cs:

public partial class Label
{
    public string Format() => $"{Name} #{Number}";
}

Результат:

Sensor #12

Частичная структура с размерами и вычислением площади

Файл Example.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <LangVersion>14.0</LangVersion>
    <Nullable>enable</Nullable>
    
  </PropertyGroup>

</Project>

Файл Program.cs:

using System;
internal static class Program
{
    public static void Main()
    {
        var size = new Rectangle { Width = 8, Height = 6 };
        Console.WriteLine(size.Area);
    }
}

Файл Rectangle.Size.cs:

public partial struct Rectangle
{
    public int Width { get; init; }
    public int Height { get; init; }
}

Файл Rectangle.Area.cs:

public partial struct Rectangle
{
    public int Area => Width * Height;
}

Результат:

48

Официальный источник: Microsoft Learn.