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


Практическое руководство. Использование программы командной строки настройки модели служб COM+

Выбрав нужный режим размещения, с помощью программы командной строки настройки модели служб COM+ (ComSvcConfig.exe) сконфигурируйте интерфейсы приложения, предоставляемые как веб-службы.

Примечание.

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

При использовании ComSvcConfig.exe на компьютере под управлением Windows 7 для настройки веб-службы на использование последней версии модели службы (в настоящее время v4.5) выполните следующие действия.

  1. Задайте для раздела [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR реестра значение DWORD 0x00000001

  2. Запустите comsvcconfig.exe

  3. Верните ключу реестра, добавленному на шаге 1, исходное значение или удалите его, если нет.

Внимание

Восстановление значения ключа - важно. Это ключ совместимости. Если не восстановить значение ключа, могут возникнуть проблемы в работе других приложений .NET на данном компьютере.

Предупреждение

При использовании ComSvcConfig.exe /install на компьютере с Windows 8 отображается диалоговое окно с сообщением "Приложение на компьютере требует следующей функции Windows: платформа .NET Framework 3.5 (включает .NET 2.0 и .NET 3.0", если платформа .NET Framework 3.5 не установлен. Это диалоговое окно можно пропустить. В качестве альтернативы можно задать ключу реестра OnlyUseLatestCLR значение DWORD 0x00000001

Добавление интерфейса с помощью режима размещения COM+

  • Выполните программу ComSvcConfig с параметрами /install и /hosting:complus, как показано в следующем примере.

    ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
    

    Эта команда добавляет интерфейс IFinances компонента ItemOrders.IFinancial (из приложения COM+ OnlineStore) в набор интерфейсов, предоставляемых как веб-службы. Данная служба использует режим размещения COM+, а потому для нее требуется явное включение приложения.

    Можно использовать подстановочный знак - звездочку (*) для компонента и интерфейса, однако это не рекомендуется, поскольку зачастую желательно предоставлять в качестве веб-службы лишь определенный набор функциональных возможностей. При использовании с более новой версией компонента подстановочный знак может (вопреки замыслу разработчика) предоставить интерфейсы, отсутствовавшие на момент определения синтаксиса конфигурации.

    При использовании параметра /verbose программа отображает предупреждения (помимо ошибок).

    Контракт для предоставленной службы содержит все методы интерфейса IFinances.

Добавление определенных методов из интерфейса с помощью режима размещения COM+

  • Запустите программу ComSvcConfig с параметрами /install и /hosting:complus, явно указав имена требуемых методов, как показано в следующем примере.

    ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose
    

    Эта команда добавляет только методы Credit и Debit из интерфейса IFinances как операции в контракт предоставляемой службы. Все прочие методы интерфейса не добавляются в контракт и не вызываются клиентами веб-службы.

Добавление интерфейса с помощью режима веб-размещения

  • Выполните программу ComSvcConfig с параметрами /install и /hosting:was, как показано в следующем примере.

    ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose
    

    Эта команда добавляет интерфейс IStockLevels компонента ItemInventory.Warehouse (из приложения COM+ OnlineWarehouse) в набор интерфейсов, предоставляемых как веб-службы. Служба размещается на веб-сервере в виртуальном каталоге OnlineWarehouse службы IIS, а не COM+, а потому приложение включается автоматически по мере необходимости.

    Чтобы воспользоваться конфигурацией с внутрипроцессным размещением на веб-сервере, приложение COM+ необходимо настроить для запуска как библиотечное приложение, а не серверное (с помощью консоли администрирования "Службы компонентов"). Приложения, настроенные как серверные, используют стандартный режим размещения на веб-сервере, что приводит к переходам процесса при обработке каждого запроса.

    Параметр /mex добавляет дополнительную конечную точку службы обмена метаданными (MEX), использующую тот же транспорт, что и конечная точка службы приложения, для поддержки клиентов, которым требуется извлечь определение контракта от службы.

Удаление веб-службы для указанного интерфейса

  • Выполните программу ComSvcConfig с параметром /uninstall, как показано в следующем примере.

    ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus
    

    Эта команда удаляет интерфейс IFinances компонента ItemOrders.Financial (из приложения COM+ OnlineStore).

Вывод списка доступных в настоящее время интерфейсов

  • Выполните программу ComSvcConfig с параметром /list, как показано в следующем примере.

    ComSvcConfig.exe /list
    

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

Вывод списка определенных доступных в настоящее время интерфейсов

  • Выполните программу ComSvcConfig с параметром /list, как показано в следующем примере.

    ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
    

    Эта команда выводит список предоставляемых в данный момент интерфейсов, размещенных в COM+, а также соответствующий адрес и сведения о привязке для приложения COM+ OnlineStore на локальном компьютере.

Отображение справки по параметрам

  • Запустите программу ComSvcConfig с параметром /? как показано в следующем примере.

    ComSvcConfig.exe /?
    

См. также