InstallerCollection 类

参考

定义

命名空间:: System.Configuration.Install

程序集:: System.Configuration.Install.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

包含要在安装过程中运行的安装程序的集合。

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

public class InstallerCollection : System.Collections.CollectionBase

type InstallerCollection = class
    inherit CollectionBase

Public Class InstallerCollection
Inherits CollectionBase

继承: Object

CollectionBase
InstallerCollection

示例

下面的示例演示 Add 类的 InstallerCollection 方法。此示例提供类似于 Installutil.exe (Installer Tool) 的实现。它安装具有该特定程序集前面的选项的程序集。如果未为程序集指定选项，则当列表中有上一个程序集时，将采用上一个程序集的选项。如果指定了“/u”或“/uninstall”选项，则卸载程序集。如果提供了“/？”或“/help”选项，则会向控制台显示帮助信息。

#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

注解

InstallerCollection提供应用程序管理对象集合Installer所需的方法和属性。

使用以下三种方法之一将安装程序添加到集合：

方法 Add 将单个安装程序添加到集合。
方法 AddRange 将多个安装程序添加到集合。
方法和 Insert Item[] 属性（即 InstallerCollection 索引器）各自将单个安装程序添加到集合中的指定索引处。

通过 Remove 方法删除安装程序。使用 Contains 方法检查安装程序是否在集合中。使用 IndexOf 方法查找安装程序在集合中的位置。

当包含集合的安装程序（由 Installer.Parent 属性指定）调用其 Install、 Commit、 Rollback或 Uninstall 方法时，将运行集合中的安装程序。

有关安装程序集合用法的示例，请参阅 AssemblyInstaller 和 TransactedInstaller 类。

属性

Capacity	获取或设置 CollectionBase 可包含的元素数。 (继承自 CollectionBase)
Count	获取 CollectionBase 实例中包含的元素数。不能重写此属性。 (继承自 CollectionBase)
InnerList	获取一个 ArrayList，它包含 CollectionBase 实例中元素的列表。 (继承自 CollectionBase)
Item[Int32]	获取或设置指定索引处的安装程序。
List	获取一个 IList，它包含 CollectionBase 实例中元素的列表。 (继承自 CollectionBase)

方法

Add(Installer)	向该安装程序集合添加指定的安装程序。
AddRange(Installer[])	向此集合添加一组指定的安装程序。
AddRange(InstallerCollection)	向此集合添加指定的安装程序的集合。
Clear()	从 CollectionBase 实例移除所有对象。不能重写此方法。 (继承自 CollectionBase)
Contains(Installer)	确定指定的安装程序是否包含在集合中。
CopyTo(Installer[], Int32)	从指定的索引处开始，将集合中的项复制到数组。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问 CollectionBase 实例的枚举器。 (继承自 CollectionBase)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(Installer)	确定集合中指定安装程序的索引。
Insert(Int32, Installer)	将指定的安装程序插入集合中的指定索引处。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnClear()	清除 CollectionBase 实例的内容时执行其他自定义进程。 (继承自 CollectionBase)
OnClearComplete()	在清除 CollectionBase 实例的内容之后执行其他自定义进程。 (继承自 CollectionBase)
OnInsert(Int32, Object)	在将一个新的安装程序插入此集合之前执行其他自定义进程。
OnInsertComplete(Int32, Object)	在向 CollectionBase 实例中插入新元素之后执行其他自定义进程。 (继承自 CollectionBase)
OnRemove(Int32, Object)	在将一个安装程序从此集合移除之前执行其他自定义进程。
OnRemoveComplete(Int32, Object)	在从 CollectionBase 实例中移除元素之后执行其他自定义进程。 (继承自 CollectionBase)
OnSet(Int32, Object, Object)	将现有的安装程序设置为新值之前执行其他自定义进程。
OnSetComplete(Int32, Object, Object)	当在 CollectionBase 实例中设置值后执行其他自定义进程。 (继承自 CollectionBase)
OnValidate(Object)	当验证值时执行其他自定义进程。 (继承自 CollectionBase)
Remove(Installer)	从集合中移除指定的 Installer。
RemoveAt(Int32)	移除 CollectionBase 实例的指定索引处的元素。此方法不可重写。 (继承自 CollectionBase)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	从目标数组的指定索引处开始将整个 CollectionBase 复制到兼容的一维 Array。 (继承自 CollectionBase)
ICollection.IsSynchronized	获取一个值，该值指示是否同步对 CollectionBase 的访问（线程安全）。 (继承自 CollectionBase)
ICollection.SyncRoot	获取可用于同步对 CollectionBase 的访问的对象。 (继承自 CollectionBase)
IList.Add(Object)	将对象添加到 CollectionBase 的结尾处。 (继承自 CollectionBase)
IList.Contains(Object)	确定 CollectionBase 是否包含特定元素。 (继承自 CollectionBase)
IList.IndexOf(Object)	搜索指定的 Object，并返回整个 CollectionBase 中第一个匹配项的从零开始的索引。 (继承自 CollectionBase)
IList.Insert(Int32, Object)	将元素插入 CollectionBase 的指定索引处。 (继承自 CollectionBase)
IList.IsFixedSize	获取一个值，该值指示 CollectionBase 是否具有固定大小。 (继承自 CollectionBase)
IList.IsReadOnly	获取一个值，该值指示 CollectionBase 是否为只读。 (继承自 CollectionBase)
IList.Item[Int32]	获取或设置指定索引处的元素。 (继承自 CollectionBase)
IList.Remove(Object)	从 CollectionBase 中移除特定对象的第一个匹配项。 (继承自 CollectionBase)

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

通过

InstallerCollection 类

定义

示例

注解

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源