AssemblyCollection Clase

Referencia

Definición

Espacio de nombres:: System.Web.Configuration

Ensamblado:: System.Web.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í.

Representa una colección de objetos AssemblyInfo. Esta clase no puede heredarse.

public ref class AssemblyCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.AssemblyInfo))]
public sealed class AssemblyCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.AssemblyInfo))>]
type AssemblyCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class AssemblyCollection
Inherits ConfigurationElementCollection

Herencia: Object

ConfigurationElement

ConfigurationElementCollection
AssemblyCollection

Atributos: ConfigurationCollectionAttribute

Ejemplos

En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar mediante declaración valores para varias propiedades de la AssemblyCollection clase . En el segundo se muestra cómo usar miembros de la AssemblyCollection clase .

En el siguiente ejemplo de archivo de configuración se muestra cómo especificar de forma declarativa valores para varias propiedades de la AssemblyCollection clase .

<system.web>  
  <compilation>   
    <assemblies>  
      <add assembly="mscorlib" />  
      <add assembly="System, Version=2.0.0.0, Culture=neutral,   
        PublicKeyToken=b77a5c561934e089" />  
      <add assembly="System.Configuration, Version=2.0.0.0,   
        Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.Web, Version=2.0.0.0, Culture=neutral,   
        PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.Data, Version=2.0.0.0, Culture=neutral,   
        PublicKeyToken=b77a5c561934e089" />  
      <add assembly="System.Web.Services, Version=2.0.0.0,   
        Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.Xml, Version=2.0.0.0, Culture=neutral,   
        PublicKeyToken=b77a5c561934e089" />  
      <add assembly="System.Drawing, Version=2.0.0.0,   
        Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.EnterpriseServices, Version=2.0.0.0,   
        Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.Web.Mobile, Version=2.0.0.0,   
        Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="System.Web.UI.MobileControls.Adapters,   
        Version=2.0.0.0, Culture=neutral,   
        PublicKeyToken=b03f5f7f11d50a3a" />  
      <add assembly="*" />  
    </assemblies>  
  </compilation>  
</system.web>

En el ejemplo de código siguiente se muestra cómo usar miembros de la AssemblyCollection clase .

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingAssemblyCollection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config = 
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        CompilationSection configSection =
          (CompilationSection)config.GetSection("system.web/compilation");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Create a new assembly reference.
        AssemblyInfo myAssembly = 
          new AssemblyInfo("MyAssembly, Version=1.0.0000.0, " +
          "Culture=neutral, Public KeyToken=b03f5f7f11d50a3a");
        // Add an assembly to the configuration.
        configSection.Assemblies.Add(myAssembly);

        // Add a second assembly reference.
        AssemblyInfo myAssembly2 = new AssemblyInfo("MyAssembly2");
        configSection.Assemblies.Add(myAssembly2);

        // Assembly Collection
        int i = 1;
        int j = 1;
        foreach (AssemblyInfo assemblyItem in configSection.Assemblies)
        {
          Console.WriteLine();
          Console.WriteLine("Assemblies {0} Details:", i);
          Console.WriteLine("Type: {0}", assemblyItem.ElementInformation.Type);
          Console.WriteLine("Source: {0}", assemblyItem.ElementInformation.Source);
          Console.WriteLine("LineNumber: {0}", assemblyItem.ElementInformation.LineNumber);
          Console.WriteLine("Properties Count: {0}", 
            assemblyItem.ElementInformation.Properties.Count);
          j = 1;
          foreach (PropertyInformation propertyItem in assemblyItem.ElementInformation.Properties)
          {
            Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name);
            Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value);
            j++;
          }
          i++;
        }

        // Remove an assembly.
        configSection.Assemblies.Remove("MyAssembly, Version=1.0.0000.0, " +
          "Culture=neutral, Public KeyToken=b03f5f7f11d50a3a");

        // Remove an assembly.
        configSection.Assemblies.RemoveAt(configSection.Assemblies.Count - 1);

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait.
      Console.ReadLine();
    }
  }
}

Imports System.Configuration
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingAssemblyCollection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As System.Web.Configuration.CompilationSection = _
         CType(config.GetSection("system.web/compilation"), _
         System.Web.Configuration.CompilationSection)

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")
        Console.WriteLine()

        ' Display Config details.
        Console.WriteLine("File Path: {0}", _
         config.FilePath)
        Console.WriteLine("Section Path: {0}", _
         configSection.SectionInformation.Name)

        ' Create a new assembly reference.
        Dim myAssembly As AssemblyInfo = New AssemblyInfo("MyAssembly, " + _
        "Version=1.0.0000.0, Culture=neutral, Public KeyToken=b03f5f7f11d50a3a")
        ' Add an assembly to the configuration.
        configSection.Assemblies.Add(myAssembly)

        ' Add a second assembly reference.
        Dim myAssembly2 As AssemblyInfo = New AssemblyInfo("MyAssembly2")
        configSection.Assemblies.Add(myAssembly2)

        ' Assembly Collection
        Dim i = 1
        Dim j = 1
        For Each assemblyItem As AssemblyInfo In configSection.Assemblies
          Console.WriteLine()
          Console.WriteLine("Assemblies {0} Details:", i)
          Console.WriteLine("Type: {0}", assemblyItem.ElementInformation.Type)
          Console.WriteLine("Source: {0}", assemblyItem.ElementInformation.Source)
          Console.WriteLine("LineNumber: {0}", assemblyItem.ElementInformation.LineNumber)
          Console.WriteLine("Properties Count: {0}", assemblyItem.ElementInformation.Properties.Count)
          j = 1
          For Each propertyItem As PropertyInformation In assemblyItem.ElementInformation.Properties
            Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name)
            Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value)
            j = j + 1
          Next
          i = i + 1
        Next

        ' Remove an assembly.
        configSection.Assemblies.Remove("MyAssembly, Version=1.0.0000.0, " + _
          "Culture=neutral, Public KeyToken=b03f5f7f11d50a3a")

        ' Remove an assembly.
        configSection.Assemblies.RemoveAt(configSection.Assemblies.Count - 1)

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Comentarios

La AssemblyCollection clase no hace referencia a ningún elemento real del archivo de configuración subyacente. Es una construcción que permite el acceso a la información del ensamblado que contiene.

Constructores

AssemblyCollection()

Inicializa una nueva instancia de la clase AssemblyCollection.

Propiedades

AddElementName	Obtiene o establece el nombre del objeto ConfigurationElement que se va a asociar a la operación de adición en la colección ConfigurationElementCollection cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
ClearElementName	Obtiene o establece el nombre del objeto ConfigurationElement que se va a asociar a la operación de borrado en la colección ConfigurationElementCollection cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
CollectionType	Obtiene el tipo de ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
Count	Obtiene el número de elementos de la colección. (Heredado de ConfigurationElementCollection)
CurrentConfiguration	Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement)
ElementInformation	Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Heredado de ConfigurationElement)
ElementName	Obtiene el nombre que se utiliza para identificar esta colección de elementos en el archivo de configuración cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
ElementProperty	Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Heredado de ConfigurationElement)
EmitClear	Obtiene o establece un valor que especifica si se ha borrado la colección. (Heredado de ConfigurationElementCollection)
EvaluationContext	Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
HasContext	Obtiene un valor que indica si la propiedad CurrentConfiguration es `null`. (Heredado de ConfigurationElement)
IsSynchronized	Obtiene un valor que indica si se sincroniza el acceso a la recopilación. (Heredado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement)
Item[Int32]	Obtiene o establece el objeto AssemblyInfo en el índice especificado de AssemblyCollection.
Item[String]	Obtiene el elemento identificado por el nombre de ensamblado especificado.
LockAllAttributesExcept	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockAllElementsExcept	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockAttributes	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockElements	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockItem	Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement)
Properties	Obtiene la colección de propiedades. (Heredado de ConfigurationElement)
RemoveElementName	Obtiene o establece el nombre del objeto ConfigurationElement que se va a asociar a la operación de eliminación en la colección ConfigurationElementCollection cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
SyncRoot	Obtiene un objeto que se utiliza para sincronizar el acceso a la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
ThrowOnDuplicate	Obtiene un valor que indica si el intento de agregar un objeto ConfigurationElement duplicado a la colección ConfigurationElementCollection va a hacer que se produzca una excepción. (Heredado de ConfigurationElementCollection)

Métodos

Add(AssemblyInfo)	Agrega un objeto AssemblyInfo a la colección AssemblyCollection.
BaseAdd(ConfigurationElement)	Agrega un elemento de configuración a la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection)
BaseClear()	Quita todos los objetos de elemento de configuración de la colección. (Heredado de ConfigurationElementCollection)
BaseGet(Int32)	Obtiene el elemento de configuración en la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
BaseGet(Object)	Devuelve el elemento de configuración con la clave especificada. (Heredado de ConfigurationElementCollection)
BaseGetAllKeys()	Devuelve una matriz de claves para todos los elementos de configuración incluidos en la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtiene la clave para el objeto ConfigurationElement en la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica el índice del objeto ConfigurationElement especificado. (Heredado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica si el objeto ConfigurationElement con la clave especificada se ha quitado de la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
BaseRemove(Object)	Quita una clase ConfigurationElement de la colección. (Heredado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Quita el objeto ConfigurationElement en la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
Clear()	Quita todos los objetos AssemblyInfo de la colección AssemblyCollection.
CopyTo(ConfigurationElement[], Int32)	Copia el contenido de la colección ConfigurationElementCollection en una matriz. (Heredado de ConfigurationElementCollection)
CreateNewElement()	Cuando se reemplaza en una clase derivada, se crea un nuevo objeto ConfigurationElement. (Heredado de ConfigurationElementCollection)
CreateNewElement(String)	Crea un nuevo objeto ConfigurationElement cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lee XML del archivo de configuración. (Heredado de ConfigurationElement)
Equals(Object)	Compara la colección ConfigurationElementCollection con el objeto especificado. (Heredado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Cuando se reemplaza en una clase derivada, obtiene la clave de elemento para un elemento de configuración especificado. (Heredado de ConfigurationElementCollection)
GetEnumerator()	Obtiene una interfaz IEnumerator que se utiliza para recorrer en iteración la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
GetHashCode()	Obtiene un valor único que representa la instancia de ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement)
GetTransformedTypeString(String)	Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Init()	Establece el objeto ConfigurationElement en su estado inicial. (Heredado de ConfigurationElement)
InitializeDefault()	Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
IsElementName(String)	Indica si el objeto ConfigurationElement especificado existe en la colección ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica si la ConfigurationElement se puede quitar de ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
IsModified()	Indica si se ha modificado esta colección ConfigurationElementCollection desde la última vez en que se guardo o cargó al reemplazarla en una clase derivada. (Heredado de ConfigurationElementCollection)
IsReadOnly()	Indica si la el objeto ConfigurationElementCollection es de solo lectura. (Heredado de ConfigurationElementCollection)
ListErrors(IList)	Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Heredado de ConfigurationElement)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hace que el sistema de configuración produzca una excepción. (Heredado de ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Se inicia una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement)
PostDeserialize()	Se llama a este método después de la deserialización. (Heredado de ConfigurationElement)
PreSerialize(XmlWriter)	Se llama a este método antes de la serialización. (Heredado de ConfigurationElement)
Remove(String)	Quita un objeto AssemblyInfo de la colección AssemblyCollection.
RemoveAt(Int32)	Quita un objeto AssemblyInfo de la colección AssemblyCollection.
Reset(ConfigurationElement)	Restablece la colección ConfigurationElementCollection a su estado sin modificaciones cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
ResetModified()	Restablece el valor de la propiedad IsModified() en `false` cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Escribe los datos de configuración en un elemento XML del archivo de configuración cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement)
SetReadOnly()	Establece la propiedad IsReadOnly() para el objeto ConfigurationElementCollection y para todos los subelementos. (Heredado de ConfigurationElementCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Invierte el efecto de combinar la información de configuración de distintos niveles de la jerarquía de configuración. (Heredado de ConfigurationElementCollection)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Copia la colección ConfigurationElementCollection en una matriz.

(Heredado de ConfigurationElementCollection)

Métodos de extensión

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

Se aplica a

Compartir a través de