InstallerCollection Kelas

Definisi

Ruang nama:

System.Configuration.Install

Rakitan:

System.Configuration.Install.dll

Berisi kumpulan alat penginstal yang akan dijalankan selama penginstalan.

public ref class InstallerCollection : System::Collections::CollectionBase

public class InstallerCollection : System.Collections.CollectionBase

type InstallerCollection = class
    inherit CollectionBase

Public Class InstallerCollection
Inherits CollectionBase

Warisan

Object

CollectionBase

InstallerCollection

Contoh

Contoh berikut menunjukkan Add metode InstallerCollection kelas . Contoh ini menyediakan implementasi yang mirip dengan Installutil.exe (Alat Penginstal). Ini menginstal rakitan dengan opsi sebelum perakitan tertentu. Jika opsi tidak ditentukan untuk assembly, opsi assembly sebelumnya diambil jika ada assembly sebelumnya dalam daftar. Jika opsi "/u" atau "/uninstall" ditentukan, rakitan akan dihapus. Jika opsi "/?" atau "/help" disediakan, informasi bantuan ditampilkan ke konsol.

#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 );
   }
}

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.");
   }
}

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

   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
End Class

Keterangan

InstallerCollection menyediakan metode dan properti yang dibutuhkan aplikasi Anda untuk mengelola kumpulan Installer objek.

Gunakan salah satu dari tiga cara berikut untuk menambahkan alat penginstal ke koleksi:

• Metode menambahkan Add satu alat penginstal ke koleksi.

• Metode menambahkan AddRange beberapa alat penginstal ke koleksi.

• Metode Insert dan Item[] properti , yang merupakan pengindeks InstallerCollection , masing-masing menambahkan satu penginstal ke koleksi pada indeks yang ditentukan.

Hapus alat penginstal melalui Remove metode . Periksa apakah alat penginstal berada dalam koleksi dengan menggunakan Contains metode . Temukan di mana alat penginstal berada di koleksi dengan menggunakan IndexOf metode .

Penginstal dalam koleksi dijalankan ketika alat penginstal yang berisi koleksi, seperti yang ditentukan oleh Installer.Parent properti , memanggil metode , Commit, Rollback, atau Uninstall merekaInstall.

Untuk contoh penggunaan koleksi alat penginstal, lihat AssemblyInstaller kelas dan TransactedInstaller .

Properti

Capacity	Mendapatkan atau mengatur jumlah elemen yang dapat dimuat CollectionBase . (Diperoleh dari CollectionBase)
Count	Mendapatkan jumlah elemen yang terkandung dalam CollectionBase instans. Properti ini tidak dapat ditimpa. (Diperoleh dari CollectionBase)
InnerList	Mendapatkan yang ArrayList berisi daftar elemen dalam CollectionBase instans. (Diperoleh dari CollectionBase)
Item[Int32]	Mendapatkan atau mengatur alat penginstal pada indeks yang ditentukan.
List	Mendapatkan yang IList berisi daftar elemen dalam CollectionBase instans. (Diperoleh dari CollectionBase)

Metode

Add(Installer)	Menambahkan alat penginstal yang ditentukan ke kumpulan alat penginstal ini.
AddRange(Installer[])	Menambahkan array penginstal yang ditentukan ke koleksi ini.
AddRange(InstallerCollection)	Menambahkan kumpulan alat penginstal yang ditentukan ke koleksi ini.
Clear()	Menghapus semua objek dari CollectionBase instans. Metode ini tidak dapat ditimpa. (Diperoleh dari CollectionBase)
Contains(Installer)	Menentukan apakah alat penginstal yang ditentukan disertakan dalam koleksi.
CopyTo(Installer[], Int32)	Menyalin item dari koleksi ke array, dimulai pada indeks yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan enumerator yang berulang melalui CollectionBase instans. (Diperoleh dari CollectionBase)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IndexOf(Installer)	Menentukan indeks alat penginstal tertentu dalam koleksi.
Insert(Int32, Installer)	Menyisipkan alat penginstal yang ditentukan ke dalam koleksi pada indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnClear()	Melakukan proses kustom tambahan saat menghapus konten instans CollectionBase . (Diperoleh dari CollectionBase)
OnClearComplete()	Melakukan proses kustom tambahan setelah menghapus konten instans CollectionBase . (Diperoleh dari CollectionBase)
OnInsert(Int32, Object)	Melakukan proses kustom tambahan sebelum alat penginstal baru dimasukkan ke dalam koleksi.
OnInsertComplete(Int32, Object)	Melakukan proses kustom tambahan setelah menyisipkan elemen baru ke CollectionBase dalam instans. (Diperoleh dari CollectionBase)
OnRemove(Int32, Object)	Melakukan proses kustom tambahan sebelum alat penginstal dihapus dari koleksi.
OnRemoveComplete(Int32, Object)	Melakukan proses kustom tambahan setelah menghapus elemen dari CollectionBase instans. (Diperoleh dari CollectionBase)
OnSet(Int32, Object, Object)	Melakukan proses kustom tambahan sebelum alat penginstal yang ada diatur ke nilai baru.
OnSetComplete(Int32, Object, Object)	Melakukan proses kustom tambahan setelah menetapkan nilai dalam CollectionBase instans. (Diperoleh dari CollectionBase)
OnValidate(Object)	Melakukan proses kustom tambahan saat memvalidasi nilai. (Diperoleh dari CollectionBase)
Remove(Installer)	Menghapus yang ditentukan Installer dari koleksi.
RemoveAt(Int32)	Menghapus elemen pada indeks CollectionBase instans yang ditentukan. Metode ini tidak dapat diganti. (Diperoleh dari CollectionBase)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Menyalin seluruh CollectionBase ke satu dimensi Arrayyang kompatibel, dimulai dari indeks array target yang ditentukan. (Diperoleh dari CollectionBase)
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan CollectionBase (utas aman). (Diperoleh dari CollectionBase)
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke CollectionBase. (Diperoleh dari CollectionBase)
IList.Add(Object)	Menambahkan objek ke akhir CollectionBase. (Diperoleh dari CollectionBase)
IList.Contains(Object)	Menentukan apakah CollectionBase berisi elemen tertentu. (Diperoleh dari CollectionBase)
IList.IndexOf(Object)	Mencari yang ditentukan Object dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh CollectionBase. (Diperoleh dari CollectionBase)
IList.Insert(Int32, Object)	Menyisipkan elemen ke dalam pada CollectionBase indeks yang ditentukan. (Diperoleh dari CollectionBase)
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah CollectionBase memiliki ukuran tetap. (Diperoleh dari CollectionBase)
IList.IsReadOnly	Mendapatkan nilai yang menunjukkan apakah CollectionBase bersifat baca-saja. (Diperoleh dari CollectionBase)
IList.Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan. (Diperoleh dari CollectionBase)
IList.Remove(Object)	Menghapus kemunculan pertama objek tertentu dari CollectionBase. (Diperoleh dari CollectionBase)

Metode Ekstensi

Cast<TResult>(IEnumerable)	Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi menjadi IEnumerableIQueryable.

Lihat juga

• Installer
• Install(IDictionary)
• Commit(IDictionary)
• Rollback(IDictionary)
• Uninstall(IDictionary)
• AssemblyInstaller
• TransactedInstaller