AssemblyCollection Classe
Definizione
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 AssemblyInfo oggetti . 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à
- Attributi
Esempio
In questa sezione vengono forniti due esempi di codice. La prima 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. Si tratta di un costrutto che consente l'accesso alle informazioni sull'assembly contenute.
Costruttori
| Nome | Descrizione |
|---|---|
| AssemblyCollection() |
Inizializza una nuova istanza della classe AssemblyCollection. |
Proprietà
| Nome | Descrizione |
|---|---|
| AddElementName |
Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di aggiunta nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| ClearElementName |
Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di cancellazione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| CollectionType |
Ottiene il tipo del ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| Count |
Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection) |
| CurrentConfiguration |
Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement) |
| ElementInformation |
Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| ElementName |
Ottiene il nome utilizzato per identificare questa raccolta di elementi nel file di configurazione quando ne viene eseguito l'override in una 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 è |
| 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 in corrispondenza dell'indice specificato nell'oggetto AssemblyCollection. |
| Item[String] |
Ottiene l'elemento identificato dal nome dell'assembly specificato. |
| LockAllAttributesExcept |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockAllElementsExcept |
Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockAttributes |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockElements |
Ottiene la raccolta 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 del ConfigurationElement da associare all'operazione di rimozione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| SyncRoot |
Ottiene un oggetto utilizzato per sincronizzare l'accesso al ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| ThrowOnDuplicate |
Ottiene un valore che indica se un tentativo di aggiungere un ConfigurationElement duplicato al ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection) |
Metodi
| Nome | Descrizione |
|---|---|
| Add(AssemblyInfo) |
Aggiunge un AssemblyInfo oggetto all'insieme AssemblyCollection . |
| BaseAdd(ConfigurationElement, Boolean) |
Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione. (Ereditato da ConfigurationElementCollection) |
| BaseAdd(ConfigurationElement) |
Aggiunge un elemento di configurazione al ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseAdd(Int32, ConfigurationElement) |
Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione. (Ereditato da ConfigurationElementCollection) |
| BaseClear() |
Rimuove tutti gli oggetti elemento di configurazione dalla raccolta. (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 per tutti gli elementi di configurazione contenuti nella ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseGetKey(Int32) |
Ottiene la chiave per il ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection) |
| BaseIndexOf(ConfigurationElement) |
Indica l'indice del ConfigurationElementspecificato. (Ereditato da ConfigurationElementCollection) |
| BaseIsRemoved(Object) |
Indica se il ConfigurationElement con la chiave specificata è stato rimosso dal ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseRemove(Object) |
Rimuove un ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection) |
| BaseRemoveAt(Int32) |
Rimuove il ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection) |
| Clear() |
Cancella tutti gli AssemblyInfo oggetti dall'insieme AssemblyCollection . |
| CopyTo(ConfigurationElement[], Int32) |
Copia il contenuto del ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection) |
| CreateNewElement() |
Quando sottoposto a override in una classe derivata, crea un nuovo ConfigurationElementoggetto . (Ereditato da ConfigurationElementCollection) |
| CreateNewElement(String) |
Crea una nuova ConfigurationElement quando ne viene eseguito l'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 il ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection) |
| GetElementKey(ConfigurationElement) |
Ottiene la chiave dell'elemento per un elemento di configurazione specificato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| GetEnumerator() |
Ottiene un IEnumerator oggetto utilizzato per scorrere l'oggetto 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 dell'assembly specificato. (Ereditato da ConfigurationElement) |
| GetTransformedTypeString(String) |
Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Init() |
Imposta l'oggetto ConfigurationElement sullo stato iniziale. (Ereditato da ConfigurationElement) |
| InitializeDefault() |
Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| IsElementName(String) |
Indica se il ConfigurationElement specificato esiste nel ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| IsElementRemovable(ConfigurationElement) |
Indica se il ConfigurationElement specificato può essere rimosso dal ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| IsModified() |
Indica se questa ConfigurationElementCollection è stata modificata dopo l'ultimo salvataggio o caricamento quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| IsReadOnly() |
Indica se l'oggetto ConfigurationElementCollection è di sola lettura. (Ereditato da ConfigurationElementCollection) |
| ListErrors(IList) |
Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Fa sì che il sistema di configurazione generi un'eccezione. (Ereditato da ConfigurationElementCollection) |
| OnRequiredPropertyNotFound(String) |
Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement) |
| PostDeserialize() |
Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chiamato prima della serializzazione. (Ereditato da ConfigurationElement) |
| Remove(String) |
Rimuove un AssemblyInfo oggetto dall'insieme AssemblyCollection . |
| RemoveAt(Int32) |
Rimuove un AssemblyInfo oggetto dall'insieme AssemblyCollection . |
| Reset(ConfigurationElement) |
Reimposta il ConfigurationElementCollection sullo stato non modificato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| ResetModified() |
Reimposta il valore della proprietà IsModified() su |
| SerializeElement(XmlWriter, Boolean) |
Scrive i dati di configurazione in un elemento XML nel file di configurazione quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| SerializeToXmlElement(XmlWriter, String) |
Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato 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 dell'unione delle informazioni di configurazione da diversi livelli della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia il ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |