Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

Исследование метаданных типов

Прежде чем приступить к созданию приложений, в которых задействована ваша специальная библиотека .NET Core, давайте займемся исследованием метаданных для типов внутри сборки CarLibrary.dll. Скажем, вот определение TypeDef для типа EnginestateEnum:

TypeDef #1 (02000002)

-------------------------------------------------------

 TypDefName: CarLibrary.EngineStateEnum

 Flags     : [Public] [AutoLayout] [Class] [Sealed] [AnsiClass]

 Extends   : [TypeRef] System.Enum

Field #1

-------------------------------------------------------

 Field Name: value__

 Flags     : [Public] [SpecialName] [RTSpecialName]

 CallCnvntn: [FIELD]

 Field type:  I4

Field #2

-------------------------------------------------------

 Field Name: EngineAlive

 Flags     : [Public] [Static] [Literal] [HasDefault]

 DefltValue: (I4) 0

 CallCnvntn: [FIELD]

 Field type:  ValueClass CarLibrary.EngineStateEnum

Field #3

-------------------------------------------------------

 Field Name: EngineDead

 Flags     : [Public] [Static] [Literal] [HasDefault]

 DefltValue: (I4) 1

 CallCnvntn: [FIELD]

 Field type:  ValueClass CarLibrary.EngineStateEnum

Как будет объясняться в следующей главе, метаданные сборки являются важным элементом платформы .NET Core и служат основой для многочисленных технологий (сериализация объектов, позднее связывание, расширяемые приложения и т.д.). В любом случае теперь, когда вы заглянули внутрь сборки CarLibrary.dll, можно приступать к построению клиентских приложений, в которых будут применяться типы из сборки.

Построение клиентского приложения C#

Поскольку все типы в CarLibrary были объявлены с ключевым словом public, другие приложения .NET Core имеют возможность пользоваться ими. Вспомните, что типы могут также определяться с применением ключевого слова internal языка C# (на самом деле это стандартный режим доступа в C# для классов). Внутренние типы могут использоваться только в сборке, где они определены. Внешние клиенты не могут ни видеть, ни создавать экземпляры типов, помеченных ключевым словом internal.

На заметку! Исключением из указанного правила является ситуация, когда сборка явно разрешает доступ другой сборке с помощью атрибута InternalsVisibleTo, который вскоре будет рассмотрен.

Чтобы воспользоваться функциональностью вашей библиотеки, создайте в том же решении, где находится CarLibrary, новый проект консольного приложения C# по имени CSharpCarClient. Вы можете добиться цели с применением Visual Studio (щелкнув правой кнопкой мыши на имени решения и выбрав в контекстном меню пункт Add►New Project (Добавить►Новый проект)) или командной строки (ниже показаны три команды, выполняемые по отдельности):

dotnet new console -lang c# -n CSharpCarClient -o .CSharpCarClient -f net5.0

dotnet add CSharpCarClient reference CarLibrary

dotnet sln .Chapter16_AppRojects.sln add .CSharpCarClient

Приведенные команды создают проект консольного приложения, добавляют к нему ссылку на проект CarLibrary и вставляют его в имеющееся решение.

На заметку! Команда add reference создает ссылку на проект, что удобно на этапе разработки, т.к. CSharpCarClient будет всегда использовать последнюю версию CarLibrary. Можно также ссылаться прямо на сборку. Прямые ссылки создаются за счет указания скомпилированной библиотеки классов.

Если решение все еще открыто в Visual Studio, тогда вы заметите, новый проект отобразится в окне Solution Explorer безо всякого вмешательства с вашей стороны.

Наконец, щелкните правой кнопкой мыши на имени CSharpCarClient в окне Solution Explorer и выберите в контекстном меню пункт Set as Startup Project (Установить как стартовый проект). Если вы не работаете в Visual Studio, то можете запустить новый проект, введя команду dotnet run в каталоге проекта.

На заметку! Для установки ссылки на проект в Visual Studio можно также щелкнуть правой кнопкой мыши на имени проекта CSharpCarClient в окне Solution Explorer, выбрать в контекстном меню пункт Add► Reference (Добавить►Ссылка) и указать CarLibrary в узле проекта.

Теперь вы можете строить клиентское приложение для использования внешних типов. Модифицируйте начальный файл кода С#, как показано ниже:

using System;

// Не забудьте импортировать пространство имен CarLibrary!

using CarLibrary;

Console.WriteLine("***** C# CarLibrary Client App *****");

// Создать объект SportsCar.

SportsCar viper = new SportsCar("Viper", 240, 40);

viper.TurboBoost();

// Создать объект MiniVan.

MiniVan mv = new MiniVan();

mv.TurboBoost();

Console.WriteLine("Done. Press any key to terminate");

// Готово. Нажмите любую клавишу для прекращения работы