AssemblyCollection Classe

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma coleção de objetos AssemblyInfo . Essa classe não pode ser herdada.

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

Herança: Object

ConfigurationElement

ConfigurationElementCollection
AssemblyCollection

Atributos: ConfigurationCollectionAttribute

Exemplos

Esta seção fornece dois exemplos de código. O primeiro demonstra como especificar valores declarativamente para várias propriedades da AssemblyCollection classe. O segundo demonstra como usar membros da AssemblyCollection classe.

O exemplo de arquivo de configuração a seguir mostra como especificar valores declarativamente para várias propriedades da AssemblyCollection classe.

<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>

O exemplo de código a seguir demonstra como usar membros da AssemblyCollection classe.

#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

Comentários

A AssemblyCollection classe não se refere a nenhum elemento real no arquivo de configuração subjacente. É um constructo que permite o acesso às informações do assembly que ele contém.

Construtores

AssemblyCollection()

Inicializa uma nova instância da classe AssemblyCollection.

Propriedades

AddElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de adição no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ClearElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de limpeza no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
CollectionType	Obtém o tipo do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
Count	Obtém o número de elementos na coleção. (Herdado de ConfigurationElementCollection)
CurrentConfiguration	Obtém uma referência para a instância Configuration de nível superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement)
ElementInformation	Obtém um objeto ElementInformation que contém as informações não personalizáveis e a funcionalidade do objeto ConfigurationElement. (Herdado de ConfigurationElement)
ElementName	Obtém o nome usado para identificar esta coleção de elementos no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ElementProperty	Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement)
EmitClear	Obtém ou define um valor que especifica se a coleção foi limpa. (Herdado de ConfigurationElementCollection)
EvaluationContext	Obtém o objeto ContextInformation para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
HasContext	Obtém um valor que indica se a propriedade CurrentConfiguration é `null`. (Herdado de ConfigurationElement)
IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado. (Herdado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou um atributo desse elemento de configuração. (Herdado de ConfigurationElement)
Item[Int32]	Obtém ou define o AssemblyInfo no índice especificado na AssemblyCollection.
Item[String]	Obtém o item identificado pelo nome de assembly especificado.
LockAllAttributesExcept	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockAllElementsExcept	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockAttributes	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockElements	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockItem	Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement)
Properties	Obtém a coleção de propriedades. (Herdado de ConfigurationElement)
RemoveElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de remoção no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SyncRoot	Obtém um objeto usado para sincronizar o acesso ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
ThrowOnDuplicate	Obtém um valor que indica se uma tentativa de adicionar uma duplicata ConfigurationElement ao ConfigurationElementCollection fará com que uma exceção seja lançada. (Herdado de ConfigurationElementCollection)

Métodos

Add(AssemblyInfo)	Adiciona um objeto AssemblyInfo à coleção AssemblyCollection.
BaseAdd(ConfigurationElement)	Adiciona um elemento de configuração ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseClear()	Remove todos os objetos de elemento de configuração da coleção. (Herdado de ConfigurationElementCollection)
BaseGet(Int32)	Obtém o elemento de configuração no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseGet(Object)	Retorna o elemento de configuração com a chave especificada. (Herdado de ConfigurationElementCollection)
BaseGetAllKeys()	Retorna uma matriz das chaves para todos os elementos de configuração contidos no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtém a chave para o ConfigurationElement no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica o índice do ConfigurationElement especificado. (Herdado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se o ConfigurationElement com a chave especificada foi removido do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseRemove(Object)	Remove um ConfigurationElement da coleção. (Herdado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Remove o ConfigurationElement no local de índice especificado. (Herdado de ConfigurationElementCollection)
Clear()	Limpa todos os objetos AssemblyInfo da coleção AssemblyCollection.
CopyTo(ConfigurationElement[], Int32)	Copia o conteúdo do ConfigurationElementCollection para uma matriz. (Herdado de ConfigurationElementCollection)
CreateNewElement()	Quando substituído em uma classe derivada, cria um novo ConfigurationElement. (Herdado de ConfigurationElementCollection)
CreateNewElement(String)	Cria um novo ConfigurationElement quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara o ConfigurationElementCollection ao objeto especificado. (Herdado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtém a chave de elemento para um elemento de configuração especificado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
GetEnumerator()	Obtém um IEnumerator que é usado para iterar por meio de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetHashCode()	Obtém um valor exclusivo que representa a instância ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement)
GetTransformedTypeString(String)	Retorna a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Init()	Define o objeto ConfigurationElement para seu estado inicial. (Herdado de ConfigurationElement)
InitializeDefault()	Usado para inicializar um conjunto padrão de valores para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
IsElementName(String)	Indica se o ConfigurationElement especificado existe no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se o ConfigurationElement especificado pode ser removido de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsModified()	Indica se este ConfigurationElementCollection foi modificado desde a última vez em que foi salvo ou carregado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
IsReadOnly()	Indica se o objeto ConfigurationElementCollection é somente leitura. (Herdado de ConfigurationElementCollection)
ListErrors(IList)	Adiciona os erros de propriedade inválida deste objeto ConfigurationElement e de todos os subelementos à lista passada. (Herdado de ConfigurationElement)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtém um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Faz com que o sistema de configuração lance uma exceção. (Herdado de ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement)
PostDeserialize()	Chamado depois da desserialização. (Herdado de ConfigurationElement)
PreSerialize(XmlWriter)	Chamado antes da serialização. (Herdado de ConfigurationElement)
Remove(String)	Remove um objeto AssemblyInfo da coleção AssemblyCollection.
RemoveAt(Int32)	Remove um objeto AssemblyInfo da coleção AssemblyCollection.
Reset(ConfigurationElement)	Redefine o ConfigurationElementCollection para seu estado inalterado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ResetModified()	Redefine o valor da propriedade IsModified() para `false` quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Grava os dados de configuração em um elemento XML no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement)
SetReadOnly()	Define a propriedade IsReadOnly() para o objeto ConfigurationElementCollection e para todos os subelementos. (Herdado de ConfigurationElementCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte o efeito da mesclagem de informações de configuração de diferentes níveis da hierarquia de configuração. (Herdado de ConfigurationElementCollection)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia o ConfigurationElementCollection para uma matriz.

(Herdado de ConfigurationElementCollection)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Partilhar via