InstallerCollection Clase

Definición

Espacio de nombres:: System.Configuration.Install

Ensamblado:: System.Configuration.Install.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Contiene una colección de instaladores que se van a ejecutar durante una instalación.

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

public class InstallerCollection : System.Collections.CollectionBase

type InstallerCollection = class
    inherit CollectionBase

Public Class InstallerCollection
Inherits CollectionBase

Herencia: Object

CollectionBase
InstallerCollection

Ejemplos

En el ejemplo siguiente se muestra el Add método de la InstallerCollection clase . En este ejemplo se proporciona una implementación similar a la de Installutil.exe (Herramienta instalador). Instala ensamblados con las opciones anteriores a ese ensamblado determinado. Si no se especifica una opción para un ensamblado, se toman las opciones del ensamblado anterior si hay un ensamblado anterior en la lista. Si se especifica la opción "/u" o "/uninstall", se desinstalan los ensamblados. Si se proporciona la opción "/?" o "/help", la información de ayuda se muestra en la consola.

#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

Comentarios

InstallerCollection proporciona los métodos y propiedades que la aplicación necesita para administrar una colección de Installer objetos.

Use cualquiera de las tres maneras siguientes de agregar instaladores a la colección:

El Add método agrega un único instalador a la colección.
Los AddRange métodos agregan varios instaladores a la colección.
El Insert método y la Item[] propiedad , que es el InstallerCollection indizador, agregan un único instalador a la colección en el índice especificado.

Quite los instaladores a través del Remove método . Compruebe si un instalador está en la colección mediante el Contains método . Busque dónde se encuentra un instalador en la colección mediante el IndexOf método .

Los instaladores de una colección se ejecutan cuando el instalador contiene la colección, según especifica la Installer.Parent propiedad , llama a sus Installmétodos , Commit, o Rollback Uninstall .

Para obtener ejemplos del uso de una colección de instaladores, consulte las AssemblyInstaller clases y TransactedInstaller .

Propiedades

Nombre	Description
Capacity	Obtiene o establece el número de elementos que CollectionBase puede contener. (Heredado de CollectionBase)
Count	Obtiene el número de elementos contenidos en la CollectionBase instancia. Esta propiedad no se puede invalidar. (Heredado de CollectionBase)
InnerList	Obtiene un ArrayList objeto que contiene la lista de elementos de la CollectionBase instancia de . (Heredado de CollectionBase)
Item[Int32]	Obtiene o establece un instalador en el índice especificado.
List	Obtiene un IList objeto que contiene la lista de elementos de la CollectionBase instancia de . (Heredado de CollectionBase)

Métodos

Nombre	Description
Add(Installer)	Agrega el instalador especificado a esta colección de instaladores.
AddRange(Installer[])	Agrega la matriz especificada de instaladores a esta colección.
AddRange(InstallerCollection)	Agrega la colección especificada de instaladores a esta colección.
Clear()	Quita todos los objetos de la CollectionBase instancia. Este método no se puede invalidar. (Heredado de CollectionBase)
Contains(Installer)	Determina si el instalador especificado se incluye en la colección.
CopyTo(Installer[], Int32)	Copia los elementos de la colección en una matriz, empezando por el índice especificado.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la CollectionBase instancia de . (Heredado de CollectionBase)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Installer)	Determina el índice de un instalador especificado en la colección.
Insert(Int32, Installer)	Inserta el instalador especificado en la colección en el índice especificado.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnClear()	Realiza procesos personalizados adicionales al borrar el contenido de la CollectionBase instancia. (Heredado de CollectionBase)
OnClearComplete()	Realiza procesos personalizados adicionales después de borrar el contenido de la CollectionBase instancia. (Heredado de CollectionBase)
OnInsert(Int32, Object)	Realiza procesos personalizados adicionales antes de insertar un nuevo instalador en la colección.
OnInsertComplete(Int32, Object)	Realiza procesos personalizados adicionales después de insertar un nuevo elemento en la CollectionBase instancia. (Heredado de CollectionBase)
OnRemove(Int32, Object)	Realiza procesos personalizados adicionales antes de quitar un instalador de la colección.
OnRemoveComplete(Int32, Object)	Realiza procesos personalizados adicionales después de quitar un elemento de la CollectionBase instancia. (Heredado de CollectionBase)
OnSet(Int32, Object, Object)	Realiza procesos personalizados adicionales antes de que un instalador existente se establezca en un nuevo valor.
OnSetComplete(Int32, Object, Object)	Realiza procesos personalizados adicionales después de establecer un valor en la CollectionBase instancia de . (Heredado de CollectionBase)
OnValidate(Object)	Realiza procesos personalizados adicionales al validar un valor. (Heredado de CollectionBase)
Remove(Installer)	Quita el especificado Installer de la colección.
RemoveAt(Int32)	Quita el elemento en el índice especificado de la CollectionBase instancia. Este método no se puede invalidar. (Heredado de CollectionBase)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
ICollection.CopyTo(Array, Int32)	Copia todo en CollectionBase una unidimensional Arraycompatible, empezando por el índice especificado de la matriz de destino. (Heredado de CollectionBase)
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a CollectionBase está sincronizado (seguro para subprocesos). (Heredado de CollectionBase)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a .CollectionBase (Heredado de CollectionBase)
IList.Add(Object)	Agrega un objeto al final de .CollectionBase (Heredado de CollectionBase)
IList.Contains(Object)	Determina si contiene CollectionBase un elemento específico. (Heredado de CollectionBase)
IList.IndexOf(Object)	Busca el especificado Object y devuelve el índice de base cero de la primera aparición dentro de todo CollectionBase. (Heredado de CollectionBase)
IList.Insert(Int32, Object)	Inserta un elemento en en el CollectionBase índice especificado. (Heredado de CollectionBase)
IList.IsFixedSize	Obtiene un valor que indica si CollectionBase tiene un tamaño fijo. (Heredado de CollectionBase)
IList.IsReadOnly	Obtiene un valor que indica si es CollectionBase de solo lectura. (Heredado de CollectionBase)
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado. (Heredado de CollectionBase)
IList.Remove(Object)	Quita la primera aparición de un objeto específico de .CollectionBase (Heredado de CollectionBase)

Métodos de extensión

Nombre	Description
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte un IEnumerable en un IQueryable.
Cast<TResult>(IEnumerable)	Convierte los elementos de un IEnumerable al tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de un IEnumerable en función de un tipo especificado.

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

InstallerCollection Clase

Definición

Ejemplos

Comentarios

Propiedades

Métodos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

Comentarios