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

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

Частные сборки должны быть разработаны для параллельной работы с другими версиями сборки в системе. Дополнительные сведения см. в Руководстве по созданию сборок side-by-side.

Частные сборки должны сопровождаться манифестом сборки . Обратите внимание, что ограничения имен применяются при упаковке библиотеки DLL в виде частной сборки, чтобы обеспечить возможность поиска частных сборок в Windows. При поиске частных сборок рекомендуется включить манифест сборки в библиотеку DLL в качестве ресурса. В этом случае идентификатор ресурса должен иметь значение 1, а имя частной сборки может совпадать с именем библиотеки DLL. Например, если имя DLL — MICROSOFT.WINDOWS.MYSAMPLE.DLL, значение атрибута name, используемого в элементе assemblyIdentity манифеста ,, также может быть Microsoft.Windows.mysample. Альтернативным способом поиска частных сборок является предоставление манифеста сборки в отдельном файле. В этом случае имя сборки и его манифеста должно отличаться от имени библиотеки DLL. Например, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest и Microsoft.Windows.mysample.dll. Дополнительные сведения о том, как параллельно выполняется поиск частных сборок, см. в последовательности поиска сборок.

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

Структура каталогов	Описание
APPDIR\MICROSOFT.TOOLS.POP.DLL	Манифест развертывается в виде ресурса в библиотеке DLL.
Appdir\Microsoft.Tools.Pop.MANIFEST	Манифест развертывается в виде отдельного файла.
APPDIR\MICROSOFT.TOOLS.POP\MICROSOFT.TOOLS.POP.DLL	Манифест развертывается в виде ресурса в библиотеке DLL, которая находится в подпапке с именем сборки.
Appdir\Microsoft.Tools.Pop\Microsoft.Tools.Pop.MANIFEST	Манифест развертывается в виде отдельного файла в подпапке с именем сборки.

 

Важный

Для версий операционной системы Windows до Windows 7 и Windows Server 2008 R2 собственные частные сборки должны быть развернуты в папке, содержащей исполняемый файл приложения. Установка в определенной папке языка или в папке с тем же именем, что и сборка, не поддерживается для собственных частных сборок.

 

Используйте одну из следующих структур каталогов для развертывания частной сборки Microsoft.tools.pop с указанным языком. В следующем примере язык, используемый Microsoft.Tools.Pop, является английским (США), а языковой код en-us. Необходимо заменить правильный код языка DHTML для сборки.

appdir\en-us\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop.MANIFEST
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.MANIFEST

Частные сборки можно установить любым методом установки, который может скопировать файл сборки в эту папку, например команду xcopy. Дополнительные сведения об установке частных сборок с помощью установщика Windows см. в разделе Установка сборок Win32.

Частные сборки также можно установить в операционных системах до Windows XP. В этом случае сборка должна быть зарегистрирована и в этих операционных системах манифест не используется. Копия частной сборки устанавливается в частную папку для эксклюзивного использования приложения. Другая версия сборки может быть глобально зарегистрирована в системе и доступна любому приложению, которое привязывается к нему. Глобальная версия сборки может быть версией, установленной с приложением или более ранней версией. Дополнительные сведения см. в разделе перенаправление DLL/COM в Windows. Сборку также можно установить как общую сборку для использования несколькими приложениями. Дополнительные сведения см. в разделе общие сборки.

Обратите внимание, что шаги по созданию частной сборки идентичны тем, которые предназначены для создания общей сборки с двумя исключениями:

• Подпись для частной сборки не обязательна, а в элементе assemblyIdentity манифеста сборки не требуется publickeyToken.
• Частные сборки можно установить в папку приложения с помощью любой технологии установки. Частные сборки не обязаны устанавливаться с помощью установщика Windows.