Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

InstallerCollection (Clase)

Contiene una colección de instaladores que se ejecutan durante una instalación.

System.Object
  System.Collections.CollectionBase
    System.Configuration.Install.InstallerCollection

Espacio de nombres:  System.Configuration.Install
Ensamblado:  System.Configuration.Install (en System.Configuration.Install.dll)

public class InstallerCollection : CollectionBase

El tipo InstallerCollection expone los siguientes miembros.

  NombreDescripción
Propiedad públicaCapacityObtiene o establece el número de elementos que puede contener la colección CollectionBase. (Se hereda de CollectionBase).
Propiedad públicaCountObtiene el número de elementos incluidos en la instancia de CollectionBase. Esta propiedad no se puede invalidar. (Se hereda de CollectionBase).
Propiedad protegidaInnerListObtiene una colección ArrayList que contiene la lista de elementos incluidos en la instancia de CollectionBase. (Se hereda de CollectionBase).
Propiedad públicaItemObtiene o establece un instalador en el índice especificado.
Propiedad protegidaListObtiene una interfaz IList que contiene la lista de elementos incluidos en la instancia de CollectionBase. (Se hereda de CollectionBase).
Arriba

  NombreDescripción
Método públicoAddAgrega el instalador especificado a esta colección de instaladores.
Método públicoAddRange(Installer[])Agrega la matriz especificada de instaladores a esta colección.
Método públicoAddRange(InstallerCollection)Agrega la colección especificada de instaladores a esta colección.
Método públicoClearElimina todos los objetos de la instancia de CollectionBase. Este método no se puede reemplazar. (Se hereda de CollectionBase).
Método públicoContainsDetermina si el instalador especificado está incluido en la colección.
Método públicoCopyToCopia los elementos de la colección en una matriz, empezando por el índice especificado.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetEnumeratorDevuelve un enumerador que recorre en iteración la instancia de CollectionBase. (Se hereda de CollectionBase).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIndexOfDetermina el índice de un instalador especificado de la colección.
Método públicoInsertInserta el instalador especificado en el índice especificado de la colección.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnClearRealiza procesos de personalización adicionales al borrar el contenido de la instancia de CollectionBase. (Se hereda de CollectionBase).
Método protegidoOnClearCompleteRealiza procesos personalizados adicionales después de borrar el contenido de la instancia de CollectionBase. (Se hereda de CollectionBase).
Método protegidoOnInsertInfraestructura. Lleva a cabo procesos personalizados adicionales antes de que se inserte un nuevo instalador en la colección. (Invalida a CollectionBase.OnInsert(Int32, Object)).
Método protegidoOnInsertCompleteRealiza procesos personalizados adicionales después de insertar un nuevo elemento en la instancia de CollectionBase. (Se hereda de CollectionBase).
Método protegidoOnRemoveInfraestructura. Lleva a cabo proceso personalizados adicionales antes de se quite un instalador de la colección. (Invalida a CollectionBase.OnRemove(Int32, Object)).
Método protegidoOnRemoveCompleteRealiza procesos de personalización adicionales después de quitar un elemento de la instancia de CollectionBase. (Se hereda de CollectionBase).
Método protegidoOnSetInfraestructura. Lleva a cabo proceso personalizados antes de que se establezca un nuevo valor para un instalador existente. (Invalida a CollectionBase.OnSet(Int32, Object, Object)).
Método protegidoOnSetCompleteRealiza procesos personalizados adicionales después de establecer un valor en la instancia de CollectionBase. (Se hereda de CollectionBase).
Método protegidoOnValidateRealiza procesos de personalización adicionales al validar un valor. (Se hereda de CollectionBase).
Método públicoRemoveQuita el Installer especificado de la colección.
Método públicoRemoveAtQuita el elemento que se encuentra en el índice especificado de la instancia de CollectionBase. Este método no se puede reemplazar. (Se hereda de CollectionBase).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoICollection.CopyToCopia la totalidad de CollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino. (Se hereda de CollectionBase).
Implementación explícita de interfacesPropiedad privadaICollection.IsSynchronizedObtiene un valor que indica si el acceso a la interfaz CollectionBase está sincronizado (es seguro para subprocesos). (Se hereda de CollectionBase).
Implementación explícita de interfacesPropiedad privadaICollection.SyncRootObtiene un objeto que se puede utilizar para sincronizar el acceso a CollectionBase. (Se hereda de CollectionBase).
Implementación explícita de interfacesMétodo privadoIList.AddAgrega un objeto al final de CollectionBase. (Se hereda de CollectionBase).
Implementación explícita de interfacesMétodo privadoIList.ContainsDetermina si CollectionBase contiene un elemento específico. (Se hereda de CollectionBase).
Implementación explícita de interfacesMétodo privadoIList.IndexOfBusca el objeto Object especificado y devuelve el índice de base cero de la primera aparición en toda la colección CollectionBase. (Se hereda de CollectionBase).
Implementación explícita de interfacesMétodo privadoIList.InsertInserta un elemento en CollectionBase, en el índice especificado. (Se hereda de CollectionBase).
Implementación explícita de interfacesPropiedad privadaIList.IsFixedSizeObtiene un valor que indica si la interfaz CollectionBase tiene un tamaño fijo. (Se hereda de CollectionBase).
Implementación explícita de interfacesPropiedad privadaIList.IsReadOnlyObtiene un valor que indica si CollectionBase es de sólo lectura. (Se hereda de CollectionBase).
Implementación explícita de interfacesPropiedad privadaIList.ItemObtiene o establece el elemento que se encuentra en el índice especificado. (Se hereda de CollectionBase).
Implementación explícita de interfacesMétodo privadoIList.RemoveQuita la primera aparición de un objeto específico de la interfaz CollectionBase. (Se hereda de CollectionBase).
Arriba

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

Siga uno de estos tres procedimientos para agregar instaladores a la colección:

  • El método Add agrega un solo instalador a la colección.

  • El método AddRange agrega varios instaladores a la colección.

  • El método Insert y la propiedad Item, que corresponden al indizador InstallerCollection, agregan (cada uno) un solo instalador a la colección en el índice especificado.

Hay que quitar los instaladores mediante el método Remove. Compruebe si hay algún instalador en la colección mediante el método Contains. Busque la ubicación de un instalador en la colección mediante el método IndexOf.

En una colección, los instaladores se ejecutan cuando el instalador que contiene la colección, tal como especifica la propiedad Installer.Parent, llama a sus métodos Install, Commit, Rollback o Uninstall.

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

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


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


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft