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

Интерфейс ICLRRuntimeHost

  • Статья

Предоставляет функциональные возможности, аналогичные функциональным возможностям интерфейса ICorRuntimeHost, которые предоставляются в платформе .NET Framework версии 1, со следующими изменениями.

  • Добавлен метод SetHostControl для установки интерфейса элемента управления ведущего приложения.

  • Опущены некоторые методы, предоставляемые интерфейсом ICorRuntimeHost.

Методы

Метод

Описание

Метод ICLRRuntimeHost::ExecuteApplication

Используется в сценарии развертывания на основе манифеста ClickOnce, чтобы задать приложение, которое необходимо активировать в новом домене.

Метода ICLRRuntimeHost::ExecuteInAppDomain

Указывает AppDomain, в котором следует выполнить указанный управляемый код.

Метод ICLRRuntimeHost::ExecuteInDefaultAppDomain

Вызывает заданный метод установленного типа в заданной сборке.

Метод ICLRRuntimeHost::GetCLRControl

Получает указатель интерфейса типа ICLRControl, с помощью которого основные приложения могут настраивать аспекты среды CLR.

Метод ICLRRuntimeHost::GetCurrentAppDomainId

Получает числовой идентификатор выполняемого в данный момент объекта AppDomain.

Метод ICLRRuntimeHost::SetHostControl

Задает интерфейс управления основным приложением. Перед вызовом метода Start следует вызвать метод SetHostControl.

Метод ICLRRuntimeHost::Start

Инициализируется среду CLR в процессе.

Метод ICLRRuntimeHost::Stop

Останавливает выполнение кода средой выполнения.

Метод ICLRRuntimeHost::UnloadAppDomain

Загружает объект AppDomain, соответствующий указанному числовому идентификатору.

Заметки

Начиная с .NET Framework 4, используйте интерфейс ICLRMetaHost для получения указателя на интерфейс ICLRRuntimeInfo и затем вызывайте метод ICLRRuntimeInfo::GetInterface для получения указателя на ICLRRuntimeHost. В более ранних версиях .NET Framework основное приложение получает указатель на экземпляр ICLRRuntimeHost с помощью вызова функции CorBindToRuntimeEx или CorBindToCurrentRuntime. Для предоставления реализаций технологий, предусмотренных в платформе .NET Framework версии 2.0 следует воспользоваться экземпляром ICLRRuntimeHost интерфейса ICorRuntimeHost.

Важное примечаниеВажно

Метод Start не следует вызывать до вызова метода ExecuteApplication для активации приложения на основе манифеста.Если сначала вызывается метод Start, при вызове метода ExecuteApplication происходит сбой.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MSCorEE.h

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0

См. также

Ссылки

Функция CorBindToCurrentRuntime

Функция CorBindToRuntimeEx

Интерфейс ICLRControl

Интерфейс ICorRuntimeHost

Компонентный класс CLRRuntimeHost

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

Общие сведения о размещении

Другие ресурсы

Интерфейсы размещения

Журнал изменений

Дата

Журнал

Причина

Июнь 2010

Исправлены инструкции по получению указателя на интерфейс.

Исправление ошибки содержимого.