, другие приложения .NET Core имеют возможность пользоваться ими. Вспомните, что типы могут также определяться с применением ключевого слова
internal
языка C# (на самом деле это стандартный режим доступа в C# для классов). Внутренние типы могут использоваться только в сборке, где они определены. Внешние клиенты не могут ни видеть, ни создавать экземпляры типов, помеченных ключевым словом
internal
.
На заметку! Исключением из указанного
правила является ситуация, когда сборка явно разрешает доступ другой сборке с помощью атрибута
InternalsVisibleTo
, который вскоре будет рассмотрен.
Чтобы воспользоваться функциональностью вашей библиотеки, создайте в том же решении, где находится
CarLibrary
, новый проект консольного приложения C# по имени
CSharpCarClient
. Вы можете добиться цели с применением Visual Studio (щелкнув правой кнопкой мыши на имени решения и выбрав в контекстном меню пункт Add?New Project (Добавить?Новый проект)) или командной строки (ниже показаны три команды, выполняемые по отдельности):
Приведенные команды создают проект консольного приложения, добавляют к нему ссылку на проект
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!
SportsCar viper = new SportsCar("Viper", 240, 40);
viper.TurboBoost;
//
Создать объект MiniVan.
MiniVan mv = new MiniVan;
mv.TurboBoost;
Console.WriteLine("Done. Press any key to terminate");
// Готово. Нажмите любую клавишу для прекращения работы
Console.ReadLine;
Код выглядит очень похожим на код в других приложениях, которые разрабатывались в книге ранее. Единственный интересный аспект связан с тем, что в клиентском приложении C# теперь применяются типы, определенные внутри отдельной специальной библиотеки. Запустив приложение, можно наблюдать отображение разнообразных сообщений.
Вас может интересовать, что в точности происходит при ссылке на проект
CarLibrary
. Когда создается ссылка на проект, порядок компиляции решения корректируется таким образом, чтобы зависимые проекты (
CarLibrary
в рассматриваемом примере) компилировались первыми и результат компиляции копировался в выходной каталог родительского проекта (
CSharpCarLibrary
). Скомпилированная клиентская библиотека ссылается на скомпилированную библиотеку классов. При повторной компиляции клиентского проекта то же самое происходит и с зависимой библиотекой, так что новая версия снова копируется в целевой каталог.
На заметку! Если вы используете Visual Studio, то можете щелкнуть на кнопке Show All Files (Показать все файлы) в окне Solution Explorer, что позволит увидеть все выходные файлы и удостовериться в наличии там скомпилированной библиотеки
CarLibrary
. Если вы работаете в Visual Studio Code, тогда перейдите в каталог
bin\debug\net5.0
на вкладке Explorer (Проводник).
Когда создается прямая ссылка, скомпилированная библиотека тоже копируется в выходной каталог клиентской библиотеки, но во время создания ссылки. Без ссылки на проект сами проекты можно компилировать независимо друг от друга и файлы могут стать несогласованными. Выражаясь кратко, если вы разрабатываете зависимые библиотеки (как обычно происходит в реальных программных проектах), то лучше ссылаться на проект, а не на результат компиляции проекта.
Построение клиентского приложения Visual Basic
Вспомните, что платформа .NET Core позволяет разработчикам разделять скомпилированный код между языками программирования. Чтобы проиллюстрировать языковую независимость платформы .NET Core, создайте еще один проект консольного приложения (по имени
VisualBasicCarClient
) на этот раз с применением языка Visual Basic (имейте в виду, что каждая команда вводится в отдельной строке):
dotnet new console -lang vb -n VisualBasicCarClient