Язык программирования C#9 и платформа .NET5

Далее добавьте в проект 
CSharpSnapIn
 ссылку на проект 
CommonSnappableTypes
. В среде Visual Studio щелкните правой кнопкой мыши на имени проекта 
CSharpSnapIn
 и выберите в контекстном меню пункт Add►Project Reference (Добавить►Ссылка на проект). В открывшемся диалоговом окне Reference Manager (Диспетчер ссылок) выберите элемент Projects►Solution (Проекты►Решение) в левой части (если он еще не выбран) и отметьте флажок рядом с 
CommonSnappableTypes
.
Повторите процесс для нового проекта библиотеки классов Visual Basic (VBSnapIn), которая ссылается на проект 
CommonSnappableTypes
.
Наконец, добавьте к решению новый проект консольного приложения .NET Core по имени 
MyExtendableApp
. Добавьте в него ссылку на проект 
CommonSnappableTypes
 и установите проект консольного приложения в качестве стартового для решения. Для этого щелкните правой кнопкой мыши на имени проекта 
MyExtendableApp
 в окне Solution Explorer и выберите в контекстном меню пункт Set as Startup Project (Установить как стартовый проект).
На заметку! Если вы щелкнете правой кнопкой мыши на имени решения 
ExtendableApp
, а не на имени одного из проектов, то в контекстном меню отобразится пункт Set Startup Projects (Установить стартовые проекты). Помимо запуска по щелчку на кнопке Run (Запустить) только одного проекта можно настроить запуск множества проектов, что будет демонстрироваться позже в книге.
  
Установка зависимостей проектов при компиляции
 
Когда среде Visual Studio поступает команда запустить решение, стартовый проект и все проекты, на которые имеются ссылки, компилируются в случае обнаружения любых изменений; однако проекты, ссылки на которые отсутствуют, не компилируются. Положение дел можно изменить, устанавливая зависимости проектов. Для этого щелкните правой кнопкой мыши на имени решения в окне Solution Explorer, выберите в контекстном меню пункт Project Build Order (Порядок компиляции проектов), в открывшемся диалоговом окне перейдите на вкладку Dependencies (Зависимости) и в раскрывающемся списке Projects (Проекты) выберите 
MyExtendableApp
.
Обратите внимание, что проект 
CommonSnappableTypes
 уже выбран и связанный с ним флажок отключен. Причина в том, что на него производится ссылка напрямую. Отметьте также флажки для проектов 
CSharpSnapIn
 и 
VBSnapIn
 (рис. 17.4).
Теперь при каждой компиляции проекта 
MyExtendableApp
 будут также компилироваться проекты 
CSharpSnapIn
 и 
VBSnapIn
.
  
Добавление событий PostBuild
 
Откройте окно свойств проекта для 
CSharpSnapIn
 (щелкнув правой кнопкой мыши на имени проекта в окне Solution Explorer и выбрав в контекстном меню пункт Properties (Свойства)) и перейдите в нем на вкладку Build Events (События при компиляции). Щелкните на кнопке Edit Post-build (Редактировать события после компиляции) и затем щелкните на Macros>> (Макросы). Здесь вы можете видеть доступные для использования макросы, которые ссылаются на пути и/или имена файлов. Преимущество применения этих макросов в событиях, связанных с компиляцией, заключается в том, что они не зависят от машины и работают с относительными путями. Скажем, кто-то работает в каталоге по имени 
c-sharp-wf\code\chapterl7
. Вы можете работать в другом каталоге (вероятнее всего так и есть). За счет применения макросов инструмент MSBuild всегда будет использовать корректный путь относительно файлов 
*.csproj
.
 
Введите в области PostBuild (После компиляции) следующие две строки:
copy $(TargetPath) $(SolutionDir)MyExtendableApp\$(OutDir)$(TargetFileName) /Y
copy $(TargetPath) $(SolutionDir)MyExtendableApp\$(TargetFileName) /Y
Сделайте то же самое для проекта 
VBSnapin
, но здесь вкладка в окне свойств называется Compile (Компиляция) и на ней понадобится щелкнуть на кнопке Build Events (События при компиляции).
Когда показанные выше команды событий после компиляции добавлены, все сборки при каждой компиляции будут копироваться в каталог проекта и выходной каталог приложения 
MyExtendableApp
.
  
Построение сборки CommonSnappableTypes.dll
 
Удалите стандартный файл класса 
Class1.cs
 из проекта 
CommonSnappableTypes
, добавьте новый файл интерфейса по имени 
AppFunctionality.cs
 и поместите в него следующий код:
namespace CommonSnappableTypes
{
  public interface IAppFunctionality
  {
    void DoIt();
  }
}
Добавьте файл класса по имени 
CompanyInfoAttribute.cs
 и приведите его содержимое к такому виду:
using System;
namespace CommonSnappableTypes
{
  [AttributeUsage(AttributeTargets.Class)]
  public sealed class CompanyInfoAttribute : System.Attribute
  {
    public string CompanyName { get; set; }
    public string CompanyUrl { get; set; }
  }
}
Тип 
IAppFunctionality
 обеспечивает полиморфный интерфейс для всех оснасток, которые могут потребляться расширяемым приложением. Учитывая, что рассматриваемый пример является полностью иллюстративным, в интерфейсе определен единственный метод под названием 
DoIt()
.
Тип 
CompanyInfoAttribute
 — это специальный атрибут, который может применяться к любому классу, желающему подключиться к контейнеру. Как несложно заметить по определению класса, 
[CompanyInfо]
 позволяет разработчику оснастки указывать общие сведения о месте происхождения компонента.
  
Построение оснастки на C#
 
Удалите стандартный файл 
Class1.cs
 из проекта 
CSharpSnapIn
 и добавьте новый файл по имени 
CSharpModule.cs
. Поместите в него следующий код: