AssemblyInstaller Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает сборку и запускает все имеющиеся в ней установщики.
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
- Наследование
Примеры
В следующем примере 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) |