InstallerCollection.Add Method

Adds the specified installer to this collection of installers.

Namespace:  System.Configuration.Install
Assembly:  System.Configuration.Install (in System.Configuration.Install.dll)

Public Function Add ( _
	value As Installer _
) As Integer


Type: System.Configuration.Install.Installer

An Installer that represents the installer to add to the collection.

Return Value

Type: System.Int32
The zero-based index of the added installer.

The Parent property of the added Installer is set to specify the Installer containing this collection.

The following example is an excerpt of the example in the InstallerCollection class.

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

         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.
               ' 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))
               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'.
            End If
         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
         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())
         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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft