AssemblyCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una raccolta di oggetti AssemblyInfo. La classe non può essere ereditata.

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

Ereditarietà: Object

ConfigurationElement

ConfigurationElementCollection
AssemblyCollection

Attributi: ConfigurationCollectionAttribute

Esempio

Questa sezione fornisce due esempi di codice. Il primo illustra come specificare in modo dichiarativo i valori per diverse proprietà della AssemblyCollection classe . Il secondo illustra come usare i membri della AssemblyCollection classe .

Nell'esempio di file di configurazione seguente viene illustrato come specificare in modo dichiarativo i valori per diverse proprietà della 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>

Nell'esempio di codice seguente viene illustrato come usare i membri della 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

Commenti

La AssemblyCollection classe non fa riferimento ad alcun elemento effettivo nel file di configurazione sottostante. È un costrutto che consente l'accesso alle informazioni sull'assembly contenute.

Costruttori

AssemblyCollection()

Inizializza una nuova istanza della classe AssemblyCollection.

Proprietà

AddElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di aggiunta nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ClearElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di cancellazione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
CollectionType	Ottiene il tipo di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementName	Ottiene il nome utilizzato per identificare questo insieme di elementi nel file di configurazione quando è sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EmitClear	Ottiene o imposta un valore che specifica se l'insieme è stato cancellato. (Ereditato da ConfigurationElementCollection)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è `null`. (Ereditato da ConfigurationElement)
IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato. (Ereditato da ConfigurationElementCollection)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[Int32]	Ottiene o imposta l'oggetto AssemblyInfo dell'insieme AssemblyCollection in corrispondenza dell'indice specificato.
Item[String]	Ottiene l'elemento identificato dal nome dell'assembly specificato.
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
RemoveElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di rimozione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
SyncRoot	Ottiene un oggetto utilizzato per sincronizzare l'accesso alla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate	Ottiene un valore che indica se il tentativo di aggiungere una classe ConfigurationElement duplicata alla classe ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection)

Metodi

Add(AssemblyInfo)	Aggiunge un oggetto AssemblyInfo alla raccolta AssemblyCollection.
BaseAdd(ConfigurationElement)	Aggiunge un elemento di configurazione a ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseClear()	Rimuove tutti gli oggetti dell'elemento di configurazione dall'insieme. (Ereditato da ConfigurationElementCollection)
BaseGet(Int32)	Ottiene l'elemento di configurazione in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseGet(Object)	Restituisce l'elemento di configurazione con la chiave specificata. (Ereditato da ConfigurationElementCollection)
BaseGetAllKeys()	Restituisce una matrice delle chiavi di tutti gli elementi di configurazione inclusi nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)	Ottiene la chiave per la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica l'indice della classe ConfigurationElement specificata. (Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se la classe ConfigurationElement con la chiave specificata è stata rimossa dalla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseRemove(Object)	Rimuove un oggetto ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)	Rimuove la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
Clear()	Cancella tutti gli oggetti AssemblyInfo dall'insieme AssemblyCollection.
CopyTo(ConfigurationElement[], Int32)	Copia il contenuto della classe ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)
CreateNewElement()	Quando è sottoposto a override in una classe derivata, crea un nuovo elemento ConfigurationElement. (Ereditato da ConfigurationElementCollection)
CreateNewElement(String)	Crea una nuova classe ConfigurationElement quando è sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta la classe ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ottiene la chiave per un elemento di configurazione specificato quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
GetEnumerator()	Ottiene un'interfaccia IEnumerator utilizzata per scorrere la classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsElementName(String)	Indica se la classe ConfigurationElement specificata esiste nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se è possibile rimuovere l'oggetto ConfigurationElement da ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsModified()	Indica se questa classe ConfigurationElementCollection è stata modificata dall'ultimo salvataggio o caricamento durante l'override in una classe derivata. (Ereditato da ConfigurationElementCollection)
IsReadOnly()	Indica se l'oggetto ConfigurationElementCollection è in sola lettura. (Ereditato da ConfigurationElementCollection)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Fa generare un'eccezione al sistema di configurazione. (Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Remove(String)	Rimuove un oggetto AssemblyInfo dalla raccolta AssemblyCollection.
RemoveAt(Int32)	Rimuove un oggetto AssemblyInfo dalla raccolta AssemblyCollection.
Reset(ConfigurationElement)	Reimposta la classe ConfigurationElementCollection sullo stato non modificato quando viene sottoposta a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
ResetModified()	Reimposta il valore della proprietà IsModified() su `false` quando viene sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Scrive i dati di configurazione in un elemento XML del file di configurazione quando vengono sottoposti a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElementCollection e per tutti i sottoelementi. (Ereditato da ConfigurationElementCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte l'effetto di unione delle informazioni sulla configurazione da livelli diversi della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia ConfigurationElementCollection in una matrice.

(Ereditato da ConfigurationElementCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a