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) |