InstallerCollection-Klasse
Enthält eine Auflistung der Installationsprogramme, die während einer Installation ausgeführt werden sollen.
Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in system.configuration.install.dll)
Syntax
'Declaration
Public Class InstallerCollection
Inherits CollectionBase
'Usage
Dim instance As InstallerCollection
public class InstallerCollection : CollectionBase
public ref class InstallerCollection : public CollectionBase
public class InstallerCollection extends CollectionBase
public class InstallerCollection extends CollectionBase
Hinweise
Die InstallerCollection enthält die Methoden und Eigenschaften, die die Anwendung zum Verwalten einer Auflistung von Installer-Objekten benötigt.
Verwenden Sie zum Hinzufügen von Installationsprogrammen zur Auflistung eines der drei folgenden Verfahren:
Mit der Add-Methode wird der Auflistung ein einzelnes Installationsprogramm hinzugefügt.
Mit der AddRange-Methode werden der Auflistung mehrere Installationsprogramme hinzugefügt.
Mit der Insert-Methode und der Item-Eigenschaft, die den InstallerCollection-Indexer darstellt, wird der Auflistung jeweils ein Installationsprogramm am angegebenen Index hinzugefügt.
Mit der Remove-Methode werden Installationsprogramme entfernt. Mit der Contains-Methode wird überprüft, ob die Auflistung ein Installationsprogramm enthält. Mit der IndexOf-Methode wird ermittelt, an welcher Stelle in der Auflistung sich ein Installationsprogramm befindet.
Die in einer Auflistung enthaltenen Installationsprogramme werden ausgeführt, wenn das Installationsprogramm, das die Auflistung gemäß der Installer.Parent-Eigenschaft enthält, eine der folgenden Methoden aufruft: Install, Commit, Rollback oder Uninstall.
Beispiele für die Verwendung einer Auflistung von Installationsprogrammen finden Sie unter der AssemblyInstaller-Klasse und der TransactedInstaller-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht die Add-Methode der InstallerCollection-Klasse. Dieses Beispiel enthält eine Implementierung, die der von Installer-Tool (Installutil.exe) ähnlich ist. Darin werden Assemblys mit den der betreffenden Assembly vorangestellten Optionen installiert. Wenn für eine Assembly keine Option angegeben ist, werden die Optionen der vorhergehenden Assembly übernommen, wenn eine solche in der Liste vorhanden ist. Wenn die Option "/u" bzw. "/uninstall" angegeben wird, werden die Assemblys deinstalliert. Wenn die Option "/?" bzw. "/help" angegeben wird, werden die Hilfeinformationen auf der Konsole angezeigt.
Imports System
Imports System.ComponentModel
Imports System.Collections
Imports System.Configuration.Install
Imports System.IO
Public Class InstallerCollection_Add
'Entry point which delegates to C-style main Private Function
Public Overloads Shared Sub Main()
Main(System.Environment.GetCommandLineArgs())
End Sub
Overloads Public Shared Sub Main(args() As String)
Dim options As New ArrayList()
Dim myOption As String
Dim toUnInstall As Boolean = False
Dim toPrintHelp As Boolean = False
Dim myTransactedInstaller As New TransactedInstaller()
Dim myAssemblyInstaller As AssemblyInstaller
Dim myInstallContext As InstallContext
Try
Dim i As Integer
For i = 1 To args.Length - 1
' Process the arguments.
If args(i).StartsWith("/") Or args(i).StartsWith("-") Then
myOption = args(i).Substring(1)
' Determine whether the option is to 'uninstall' a assembly.
If String.Compare(myOption, "u", True) = 0 Or String.Compare(myOption, "uninstall", _
True) = 0 Then
toUnInstall = True
GoTo ContinueFor1
End If
' Determine whether the option is for printing help information.
If String.Compare(myOption, "?", True) = 0 Or String.Compare(myOption, "help", _
True) = 0 Then
toPrintHelp = True
GoTo ContinueFor1
End If
' Add the option encountered to the list of all options
' encountered for the current assembly.
options.Add(myOption)
Else
' Determine whether the assembly file exists.
If Not File.Exists(args(i)) Then
' If assembly file doesn't exist then print error.
Console.WriteLine(" Error : {0} - Assembly file doesn't exist.", args(i))
Return
End If
' Create an instance of 'AssemblyInstaller' that installs the given assembly.
myAssemblyInstaller = New AssemblyInstaller(args(i), CType(options.ToArray _
(GetType(String)), String()))
' Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
myTransactedInstaller.Installers.Add(myAssemblyInstaller)
End If
ContinueFor1:
Next i
' If user requested help or didn't provide any assemblies to install
' then print help message.
If toPrintHelp Or myTransactedInstaller.Installers.Count = 0 Then
PrintHelpMessage()
Return
End If
' Create an instance of 'InstallContext' with the options specified.
myInstallContext = New InstallContext("Install.log", CType(options.ToArray _
(GetType(String)), String()))
myTransactedInstaller.Context = myInstallContext
' Install or Uninstall an assembly depending on the option provided.
If Not toUnInstall Then
myTransactedInstaller.Install(New Hashtable())
Else
myTransactedInstaller.Uninstall(Nothing)
End If
Catch e As Exception
Console.WriteLine(" Exception raised : {0}", e.Message)
End Try
End Sub 'Main
Public Shared Sub PrintHelpMessage()
Console.WriteLine("Usage : InstallerCollection_Add [/u | /uninstall] [option [...]]assembly"+ _
"[[option [...]] assembly] [...]]")
Console.WriteLine("InstallerCollection_Add executes the installers in each of" + _
" the given assembly. If /u or /uninstall option is given it uninstalls the assemblies.")
End Sub 'PrintHelpMessage
End Class 'InstallerCollection_Add
using System;
using System.ComponentModel;
using System.Collections;
using System.Configuration.Install;
using System.IO;
public class InstallerCollection_Add
{
public static void Main(String[] args)
{
ArrayList options = new ArrayList();
String myOption;
bool toUnInstall = false;
bool toPrintHelp = false;
TransactedInstaller myTransactedInstaller = new TransactedInstaller();
AssemblyInstaller myAssemblyInstaller;
InstallContext myInstallContext;
try
{
for(int i = 0; i < args.Length; i++)
{
// Process the arguments.
if(args[i].StartsWith("/") || args[i].StartsWith("-"))
{
myOption = args[i].Substring(1);
// Determine whether the option is to 'uninstall' a assembly.
if(String.Compare(myOption, "u", true) == 0 ||
String.Compare(myOption, "uninstall", true) == 0)
{
toUnInstall = true;
continue;
}
// Determine whether the option is for printing help information.
if(String.Compare(myOption, "?", true) == 0 ||
String.Compare(myOption, "help", true) == 0)
{
toPrintHelp = true;
continue;
}
// Add the option encountered to the list of all options
// encountered for the current assembly.
options.Add(myOption);
}
else
{
// Determine whether the assembly file exists.
if(!File.Exists(args[i]))
{
// If assembly file doesn't exist then print error.
Console.WriteLine(" Error : {0} - Assembly file doesn't exist.", args[i]);
return;
}
// Create an instance of 'AssemblyInstaller' that installs the given assembly.
myAssemblyInstaller = new AssemblyInstaller(args[i],
(string[]) options.ToArray(typeof(string)));
// Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
myTransactedInstaller.Installers.Add(myAssemblyInstaller);
}
}
// If user requested help or didn't provide any assemblies to install
// then print help message.
if(toPrintHelp || myTransactedInstaller.Installers.Count == 0)
{
PrintHelpMessage();
return;
}
// Create an instance of 'InstallContext' with the options specified.
myInstallContext =
new InstallContext("Install.log",
(string[]) options.ToArray(typeof(string)));
myTransactedInstaller.Context = myInstallContext;
// Install or Uninstall an assembly depending on the option provided.
if(!toUnInstall)
myTransactedInstaller.Install(new Hashtable());
else
myTransactedInstaller.Uninstall(null);
}
catch(Exception e)
{
Console.WriteLine(" Exception raised : {0}", e.Message);
}
}
public static void PrintHelpMessage()
{
Console.WriteLine("Usage : InstallerCollection_Add [/u | /uninstall] [option [...]] assembly" +
"[[option [...]] assembly] [...]]");
Console.WriteLine("InstallerCollection_Add executes the installers in each of" +
" the given assembly. If /u or /uninstall option" +
" is given it uninstalls the assemblies.");
}
}
#using <System.dll>
#using <System.Configuration.Install.dll>
using namespace System;
using namespace System::ComponentModel;
using namespace System::Collections;
using namespace System::Configuration::Install;
using namespace System::IO;
void PrintHelpMessage()
{
Console::WriteLine( "Usage : InstallerCollection_Add [/u | /uninstall] [option [...]] assembly " +
"[[option [...]] assembly] [...]]" );
Console::WriteLine( "InstallerCollection_Add executes the installers in each of" +
"the given assembly. If /u or /uninstall option" +
"option is given it uninstalls the assemblies." );
}
int main()
{
array<String^>^ args = Environment::GetCommandLineArgs();
ArrayList^ options = gcnew ArrayList;
String^ myOption;
bool toUnInstall = false;
bool toPrintHelp = false;
TransactedInstaller^ myTransactedInstaller = gcnew TransactedInstaller;
AssemblyInstaller^ myAssemblyInstaller;
InstallContext^ myInstallContext;
try
{
for ( int i = 0; i < args->Length; i++ )
{
// Process the arguments.
if ( args[ i ]->StartsWith( "/" ) || args[ i ]->StartsWith( "-" ) )
{
myOption = args[ i ]->Substring( 1 );
// Determine whether the option is to 'uninstall' a assembly.
if ( String::Compare( myOption, "u", true ) == 0 ||
String::Compare( myOption, "uninstall", true ) == 0 )
{
toUnInstall = true;
continue;
}
// Determine whether the option is for printing help information.
if ( String::Compare( myOption, "?", true ) == 0 ||
String::Compare( myOption, "help", true ) == 0 )
{
toPrintHelp = true;
continue;
}
// Add the option encountered to the list of all options
// encountered for the current assembly.
options->Add( myOption );
}
else
{
// Determine whether the assembly file exists.
if ( !File::Exists( args[ i ] ) )
{
// If assembly file doesn't exist then print error.
Console::WriteLine( " Error : {0} - Assembly file doesn't exist.", args[ i ] );
return 0;
}
// Create an instance of 'AssemblyInstaller' that installs the given assembly.
myAssemblyInstaller = gcnew AssemblyInstaller( args[ i ],
(array<String^>^)(options->ToArray( String::typeid )) );
// Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
myTransactedInstaller->Installers->Add( myAssemblyInstaller );
}
}
// then print help message.
if ( toPrintHelp || myTransactedInstaller->Installers->Count == 0 )
{
PrintHelpMessage();
return 0;
}
// Create an instance of 'InstallContext' with the options specified.
myInstallContext =
gcnew InstallContext( "Install.log",
(array<String^>^)(options->ToArray( String::typeid )) );
myTransactedInstaller->Context = myInstallContext;
// Install or Uninstall an assembly depending on the option provided.
if ( !toUnInstall )
myTransactedInstaller->Install( gcnew Hashtable );
else
myTransactedInstaller->Uninstall( nullptr );
}
catch ( Exception^ e )
{
Console::WriteLine( " Exception raised : {0}", e->Message );
}
}
import System.*;
import System.ComponentModel.*;
import System.Collections.*;
import System.Configuration.Install.*;
import System.IO.*;
public class InstallerCollectionAdd
{
public static void main(String[] args)
{
ArrayList options = new ArrayList();
String myOption;
boolean toUnInstall = false;
boolean toPrintHelp = false;
TransactedInstaller myTransactedInstaller = new TransactedInstaller();
AssemblyInstaller myAssemblyInstaller;
InstallContext myInstallContext;
try {
for (int i = 0; i < args.length; i++) {
// Process the arguments.
if (args[i].StartsWith("/") || args[i].StartsWith("-")) {
myOption = args[i].Substring(1);
// Determine whether the option is to
//'uninstall' a assembly.
if (String.Compare(myOption, "u", true) == 0
|| String.Compare(myOption, "uninstall", true) == 0) {
toUnInstall = true;
continue;
}
// Determine whether the option is
//for printing help information.
if (String.Compare(myOption, "?", true) == 0
|| String.Compare(myOption, "help", true) == 0) {
toPrintHelp = true;
continue;
}
// Add the option encountered to the list of all options
// encountered for the current assembly.
options.Add(myOption);
}
else {
// Determine whether the assembly file exists.
if (!(File.Exists(args[i]))) {
// If assembly file doesn't exist then print error.
Console.WriteLine(" Error : {0} - Assembly "
+"file doesn't exist.", args[i]);
return;
}
// Create an instance of 'AssemblyInstaller'
//that installs the given assembly.
myAssemblyInstaller = new AssemblyInstaller(args[i],
(String[])(options.ToArray(String.class.ToType())));
// Add the instance of 'AssemblyInstaller'
//to the 'TransactedInstaller'.
myTransactedInstaller.get_Installers().
Add(myAssemblyInstaller);
}
}
// If user requested help or didn't provide any assemblies to
//install then print help message.
if (toPrintHelp
|| myTransactedInstaller.get_Installers().get_Count() == 0) {
PrintHelpMessage();
return;
}
// Create an instance of 'InstallContext'
//with the options specified.
myInstallContext = new InstallContext("Install.log",
(String[])(options.ToArray(String.class.ToType())));
myTransactedInstaller.set_Context(myInstallContext);
// Install or Uninstall an assembly depending
//on the option provided.
if (!(toUnInstall)) {
myTransactedInstaller.Install(new Hashtable());
}
else {
myTransactedInstaller.Uninstall(null);
}
}
catch (System.Exception e) {
Console.WriteLine(" Exception raised : {0}", e.get_Message());
}
} //main
public static void PrintHelpMessage()
{
Console.WriteLine("Usage : InstallerCollectionAdd [/u | /uninstall]"
+ " [option [...]] assembly" + "[[option [...]] assembly] [...]]");
Console.WriteLine("InstallerCollectionAdd executes the installers in"
+" each of" + " the given assembly. If /u or /uninstall option"
+ " is given it uninstalls the assemblies.");
} //PrintHelpMessage
} //InstallerCollectionAdd
Vererbungshierarchie
System.Object
System.Collections.CollectionBase
System.Configuration.Install.InstallerCollection
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
InstallerCollection-Member
System.Configuration.Install-Namespace
Installer-Klasse
Install
Commit
Rollback
Uninstall
AssemblyInstaller-Klasse
TransactedInstaller