Поделиться через


Частичный тип (справочник по C#)

Определения частичных типов позволяют разделить определение класса, структуры, интерфейса или записи на несколько определений. Эти несколько определений можно поместить в разные файлы в одном проекте. Одно объявление типа содержит только подписи для частичных элементов:

partial class A
{
    int num = 0;
    void MethodA() { }
    partial void MethodC();
}

Другое объявление содержит реализацию частичных элементов:

partial class A
{
    void MethodB() { }
    partial void MethodC() { }
}

Объявления для частичного типа могут отображаться в одном или нескольких файлах. Как правило, два объявления находятся в разных файлах. При работе с большими проектами вы разделяете класс, структуру или тип интерфейса с автоматически созданным кодом, например, предоставленным конструктором Windows Forms, или генераторами источников, такими как RegEx. Частичный тип может содержать частичные элементы.

Справочные документы по языку C# описывают последнюю выпущенную версию языка C#. Она также содержит начальную документацию по функциям в общедоступных предварительных версиях для предстоящего языкового выпуска.

Документация определяет любую функцию, впервые представленную в последних трех версиях языка или в текущих общедоступных предварительных версиях.

Подсказка

Чтобы узнать, когда функция впервые появилась в C#, ознакомьтесь со статьей об истории версий языка C#.

Начиная с C# 13, можно определить частичные свойства и частичные индексаторы. Начиная с C# 14, можно определить конструкторы частичных экземпляров и частичные события. До C# 13 только методы можно определить как частичные элементы.

Вы можете предоставить комментарии к документации по объявлению объявления или реализации объявления. При применении примечаний документации к объявлениям обоих типов XML-элементы из каждого объявления включаются в выходной XML. Правила для частичных объявлений членов см. в статье о частичных членах.

Атрибуты можно применять к любой из объявлений. Компилятор объединяет все атрибуты из обоих объявлений, включая дубликаты.

Дополнительные сведения см. в разделе Разделяемые классы и методы.

Спецификация языка C#

Дополнительные сведения см. в спецификации языка C#. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.

См. также