AssemblyInstaller Класс

Ссылка

Определение

Пространство имен:: System.Configuration.Install

Сборка:: System.Configuration.Install.dll

Важно!

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

Загружает сборку и запускает все имеющиеся в ней установщики.

public ref class AssemblyInstaller : System::Configuration::Install::Installer

public class AssemblyInstaller : System.Configuration.Install.Installer

type AssemblyInstaller = class
    inherit Installer

Public Class AssemblyInstaller
Inherits Installer

Наследование: Object

MarshalByRefObject

Component

Installer
AssemblyInstaller

Примеры

В следующем примере AssemblyInstaller создается путем вызова конструктора AssemblyInstaller . Свойства этого объекта задаются, а Install методы и Commit вызываются для установки сборки MyAssembly.exe .

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Collections;
using namespace System::Collections::Specialized;
int main()
{
   IDictionary^ mySavedState = gcnew Hashtable;
   Console::WriteLine( "" );
   try
   {
      
      // Set the commandline argument array for 'logfile'.
      array<String^>^commandLineOptions = {"/LogFile=example.log"};
      
      // Create an object of the 'AssemblyInstaller' class.
      AssemblyInstaller^ myAssemblyInstaller = gcnew AssemblyInstaller(
         "MyAssembly.exe", commandLineOptions );
      myAssemblyInstaller->UseNewContext = true;
      
      // Install the 'MyAssembly' assembly.
      myAssemblyInstaller->Install( mySavedState );
      
      // Commit the 'MyAssembly' assembly.
      myAssemblyInstaller->Commit( mySavedState );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e->Message );
   }
}

using System;
using System.Configuration.Install;
using System.Collections;
using System.Collections.Specialized;

class AssemblyInstaller_Example
{
   static void Main()
   {
      IDictionary mySavedState = new Hashtable();

      Console.WriteLine( "" );

      try
      {
         // Set the commandline argument array for 'logfile'.
         string[] commandLineOptions = new string[ 1 ] {"/LogFile=example.log"};

         // Create an object of the 'AssemblyInstaller' class.
         AssemblyInstaller myAssemblyInstaller = new
                     AssemblyInstaller( "MyAssembly.exe" , commandLineOptions );

         myAssemblyInstaller.UseNewContext = true;

         // Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install( mySavedState );

         // Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit( mySavedState );
      }
      catch (Exception e)
      {
         Console.WriteLine( e.Message );
      }
   }
}

Imports System.Configuration.Install
Imports System.Collections
Imports System.Collections.Specialized

Class AssemblyInstaller_Example

   Shared Sub Main()
      Dim mySavedState = New Hashtable()

      Console.WriteLine("")

      Try
         ' Set the commandline argument array for 'logfile'.
         Dim commandLineOptions(0) As String
         commandLineOptions(0) = "/LogFile=example.log"

         ' Create an object of the 'AssemblyInstaller' class.
         Dim myAssemblyInstaller As _
               New AssemblyInstaller("MyAssembly.exe", commandLineOptions)

         myAssemblyInstaller.UseNewContext = True

         ' Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install(mySavedState)

         ' Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit(mySavedState)
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub
End Class

Конструкторы

AssemblyInstaller()	Инициализирует новый экземпляр класса AssemblyInstaller.
AssemblyInstaller(Assembly, String[])	Инициализирует новый экземпляр класса AssemblyInstaller и задает устанавливаемую сборку и командную строку, которая используется при создании нового объекта InstallContext.
AssemblyInstaller(String, String[])	Инициализирует новый экземпляр класса AssemblyInstaller и задает одновременно имя файла устанавливаемой сборки и командную строку, используемую для установки сборки при создании нового объекта InstallContext.

Свойства

Assembly	Получает или задает устанавливаемую сборку.
CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
CommandLine	Получает или задает командную строку, используемую для установки сборки при создании нового объекта InstallContext.
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
Context	Получает или задает сведения о текущей установке. (Унаследовано от Installer)
DesignMode	Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
HelpText	Получает текст справки для всех установщиков из коллекции установщиков.
Installers	Получает коллекцию установщиков, содержащуюся в данном установщике. (Унаследовано от Installer)
Parent	Получает или задает установщик, содержащий коллекцию, к которой принадлежит данный установщик. (Унаследовано от Installer)
Path	Получает или задает путь к устанавливаемой сборке.
Site	Получает или задает ISite объекта Component. (Унаследовано от Component)
UseNewContext	Получает или задает значение, указывающее на необходимость создания для установки сборки нового объекта InstallContext.

Методы

CheckIfInstallable(String)	Проверяет возможность установки указанной сборки.
Commit(IDictionary)	Завершает транзакцию установки.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от Component)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
Install(IDictionary)	Производит установку.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnAfterInstall(IDictionary)	Вызывает событие AfterInstall. (Унаследовано от Installer)
OnAfterRollback(IDictionary)	Вызывает событие AfterRollback. (Унаследовано от Installer)
OnAfterUninstall(IDictionary)	Вызывает событие AfterUninstall. (Унаследовано от Installer)
OnBeforeInstall(IDictionary)	Вызывает событие BeforeInstall. (Унаследовано от Installer)
OnBeforeRollback(IDictionary)	Вызывает событие BeforeRollback. (Унаследовано от Installer)
OnBeforeUninstall(IDictionary)	Вызывает событие BeforeUninstall. (Унаследовано от Installer)
OnCommitted(IDictionary)	Вызывает событие Committed. (Унаследовано от Installer)
OnCommitting(IDictionary)	Вызывает событие Committing. (Унаследовано от Installer)
Rollback(IDictionary)	Возвращает компьютер в состояние, в котором он находился до установки.
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)
Uninstall(IDictionary)	Удаляет компоненты установки.

События

AfterInstall	Происходит после выполнения методов Install(IDictionary) всех установщиков из свойства Installers. (Унаследовано от Installer)
AfterRollback	Происходит после отката установок всех установщиков из свойства Installers. (Унаследовано от Installer)
AfterUninstall	Происходит после выполнения операций удаления всеми установщиками из свойства Installers. (Унаследовано от Installer)
BeforeInstall	Происходит до того, как был запущен метод Install(IDictionary) каждого установщика из коллекции установщиков. (Унаследовано от Installer)
BeforeRollback	Происходит до отката установщиков из свойства Installers. (Унаследовано от Installer)
BeforeUninstall	Происходит до выполнения операций удаления установщиками из свойства Installers. (Унаследовано от Installer)
Committed	Происходит после фиксации установки всеми установщиками из свойства Installers. (Унаследовано от Installer)
Committing	Происходит до фиксации установок установщиками из свойства Installers. (Унаследовано от Installer)
Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)

Применяется к