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


Наименование основных сборок взаимодействия

Обновлен: Ноябрь 2007

Для упрощения узнавания имя, выбранное для основной сборки взаимодействия, должно быть похоже на исходное имя библиотеки COM-типов и в то же время быть в достаточной степени конкретным, чтобы разработчики не перепутали сборки. Как и в случае с другими сборками, имя основной сборки взаимодействия заметно влияет на область ее действия и возможность использования сборки несколькими приложениями.

Имя определяется при генерации основной сборки взаимодействия. Обычно основная сборка взаимодействия создается путем импорта библиотеки типов. Сведения об импорте библиотеки типов см. в разделе Генерация основных сборок взаимодействия.

Именование элементов

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

  • Имя файла сборки.

    Имя файла сборки должно соответствовать имени сборки (не включая расширение имени файла, например EXE или DLL). По умолчанию процедура импорта использует для создания имени сборки и имени файла сборки имя библиотеки типов, а не имя файла библиотеки типов. Имя библиотеки типов и имя файла библиотеки типов не обязательно совпадают. Например, при импорте библиотеки типов MyTypeLib из файла MyComponent.tlb именем сборки по умолчанию будет MyTypeLib, а именем файла сборки по умолчанию — MyTypeLib.dll.

    Общее правило таково: для именования основной сборки взаимодействия следует использовать сочетание ИмяПоставщика.ИмяБиблиотеки. Например, чтобы полностью идентифицировать библиотеку типов MyTypeLib, опубликованную компанией MyCompany, при импорте библиотеки типов можно переопределить заданное по умолчанию имя файла сборки (MyTypeLib.dll) именем MyCompany.MyTypeLib.dll.

  • Имя пространства имен

    При импорте библиотеки типов для генерации имени пространства имен используется имя библиотеки типов. Имя, заданное во время импорта по умолчанию, можно изменить. Для пространства имен применимо то же правило, что и для файлов сборки (ИмяПоставщика.ИмяБиблиотеки).

Вопросы именования

При именовании необходимо учитывать следующие моменты.

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

  • Стратегия именования также может сохранять совместимость источников между исходной библиотекой COM-типов и основной сборкой взаимодействия, для чего необходимо использовать заданные по умолчанию имя сборки, имя файла и имя пространства имен. Хотя этот способ и менее описателен, он полезен для известных библиотек, таких как ADODB в Microsoft Visual Basic 6.0 (библиотека ADO).

См. также

Основные понятия

Создание основных сборок взаимодействия

Генерация основных сборок взаимодействия

Настройка основных сборок взаимодействия

Распространение основных сборок взаимодействия среди разработчиков