InstallerCollection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Configuration.Install

Zestaw:: System.Configuration.Install.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zawiera kolekcję instalatorów do uruchomienia podczas instalacji.

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

public class InstallerCollection : System.Collections.CollectionBase

type InstallerCollection = class
    inherit CollectionBase

Public Class InstallerCollection
Inherits CollectionBase

Dziedziczenie: Object

CollectionBase
InstallerCollection

Przykłady

W poniższym przykładzie pokazano metodę Add InstallerCollection klasy . W tym przykładzie przedstawiono implementację podobną do implementacjiInstallutil.exe (narzędzie instalatora). Instaluje zestawy z opcjami poprzedzającymi ten konkretny zestaw. Jeśli dla zestawu nie określono opcji, opcje poprzedniego zestawu zostaną podjęte, jeśli na liście znajduje się poprzedni zestaw. Jeśli zostanie określona opcja "/u" lub "/uninstall", zestawy zostaną odinstalowane. Jeśli zostanie podana opcja "/?" lub "/help", informacje pomocy zostaną wyświetlone w konsoli programu .

#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

Uwagi

Zawiera InstallerCollection metody i właściwości, które aplikacja musi zarządzać kolekcją Installer obiektów.

Użyj dowolnego z następujących trzech sposobów dodawania instalatorów do kolekcji:

Metoda Add dodaje pojedynczy instalator do kolekcji.
Metody AddRange dodają wiele instalatorów do kolekcji.
Insert Metoda i Item[] właściwość, która jest indeksatoremInstallerCollection, każdy dodaje pojedynczy instalator do kolekcji w określonym indeksie.

Usuń instalatory za pomocą Remove metody . Sprawdź, czy instalator znajduje się w kolekcji przy użyciu Contains metody . Znajdź miejsce, w którym znajduje się instalator w kolekcji przy użyciu IndexOf metody .

Instalatory w kolekcji są uruchamiane, gdy instalator zawierający kolekcję, określony przez Installer.Parent właściwość, wywołuje ich Installmetody , Commit, , Rollbacklub Uninstall .

Aby zapoznać się z przykładami użycia kolekcji instalatora, zobacz AssemblyInstaller klasy i TransactedInstaller .

Właściwości

Capacity	Pobiera lub ustawia liczbę elementów, które CollectionBase mogą zawierać. (Odziedziczone po CollectionBase)
Count	Pobiera liczbę elementów zawartych w wystąpieniu CollectionBase . Nie można zastąpić tej właściwości. (Odziedziczone po CollectionBase)
InnerList	Pobiera element ArrayList zawierający listę elementów w wystąpieniu CollectionBase . (Odziedziczone po CollectionBase)
Item[Int32]	Pobiera lub ustawia instalatora w określonym indeksie.
List	Pobiera element IList zawierający listę elementów w wystąpieniu CollectionBase . (Odziedziczone po CollectionBase)

Metody

Add(Installer)	Dodaje określony instalator do tej kolekcji instalatorów.
AddRange(Installer[])	Dodaje do tej kolekcji określoną tablicę instalatorów.
AddRange(InstallerCollection)	Dodaje do tej kolekcji określoną kolekcję instalatorów.
Clear()	Usuwa wszystkie obiekty z CollectionBase wystąpienia. Nie można zastąpić tej metody. (Odziedziczone po CollectionBase)
Contains(Installer)	Określa, czy określony instalator jest uwzględniony w kolekcji.
CopyTo(Installer[], Int32)	Kopiuje elementy z kolekcji do tablicy, zaczynając od określonego indeksu.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetEnumerator()	Zwraca moduł wyliczający, który iteruje za pośrednictwem CollectionBase wystąpienia. (Odziedziczone po CollectionBase)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IndexOf(Installer)	Określa indeks określonego instalatora w kolekcji.
Insert(Int32, Installer)	Wstawia określonego instalatora do kolekcji w określonym indeksie.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnClear()	Wykonuje dodatkowe procesy niestandardowe podczas czyszczenia zawartości CollectionBase wystąpienia. (Odziedziczone po CollectionBase)
OnClearComplete()	Wykonuje dodatkowe procesy niestandardowe po wyczyszczeniu zawartości CollectionBase wystąpienia. (Odziedziczone po CollectionBase)
OnInsert(Int32, Object)	Wykonuje dodatkowe procesy niestandardowe przed wstawieniem nowego instalatora do kolekcji.
OnInsertComplete(Int32, Object)	Wykonuje dodatkowe procesy niestandardowe po wstawieniu nowego elementu do CollectionBase wystąpienia. (Odziedziczone po CollectionBase)
OnRemove(Int32, Object)	Wykonuje dodatkowe procesy niestandardowe przed usunięciem instalatora z kolekcji.
OnRemoveComplete(Int32, Object)	Wykonuje dodatkowe procesy niestandardowe po usunięciu CollectionBase elementu z wystąpienia. (Odziedziczone po CollectionBase)
OnSet(Int32, Object, Object)	Wykonuje dodatkowe procesy niestandardowe, zanim istniejący instalator zostanie ustawiony na nową wartość.
OnSetComplete(Int32, Object, Object)	Wykonuje dodatkowe procesy niestandardowe po ustawieniu wartości w wystąpieniu CollectionBase . (Odziedziczone po CollectionBase)
OnValidate(Object)	Wykonuje dodatkowe procesy niestandardowe podczas sprawdzania poprawności wartości. (Odziedziczone po CollectionBase)
Remove(Installer)	Usuwa określony Installer element z kolekcji.
RemoveAt(Int32)	Usuwa element w określonym indeksie CollectionBase wystąpienia. Ta metoda nie jest zastępowana. (Odziedziczone po CollectionBase)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Kopiuje całą CollectionBase do zgodnej jednowymiarowej Arraytablicy, zaczynając od określonego indeksu tablicy docelowej. (Odziedziczone po CollectionBase)
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do elementu CollectionBase jest synchronizowany (bezpieczny wątek). (Odziedziczone po CollectionBase)
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu CollectionBase. (Odziedziczone po CollectionBase)
IList.Add(Object)	Dodaje obiekt na końcu obiektu CollectionBase. (Odziedziczone po CollectionBase)
IList.Contains(Object)	Określa, czy element CollectionBase zawiera określony element. (Odziedziczone po CollectionBase)
IList.IndexOf(Object)	Wyszukuje określony Object element i zwraca indeks oparty na zerowym pierwszym wystąpieniu w całym CollectionBaseobiekcie . (Odziedziczone po CollectionBase)
IList.Insert(Int32, Object)	Wstawia element do CollectionBase określonego indeksu. (Odziedziczone po CollectionBase)
IList.IsFixedSize	Pobiera wartość wskazującą, czy rozmiar CollectionBase ma stały rozmiar. (Odziedziczone po CollectionBase)
IList.IsReadOnly	Pobiera wartość wskazującą, czy kolekcja CollectionBase jest przeznaczona tylko do odczytu. (Odziedziczone po CollectionBase)
IList.Item[Int32]	Pobiera lub ustawia element pod określonym indeksem. (Odziedziczone po CollectionBase)
IList.Remove(Object)	Usuwa pierwsze wystąpienie określonego obiektu z obiektu CollectionBase. (Odziedziczone po CollectionBase)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy elementu IEnumerable na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Dotyczy

Produkt	Wersje
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Udostępnij za pośrednictwem