AssemblyCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une collection d'objets AssemblyInfo. Cette classe ne peut pas être héritée.
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
- Héritage
- Attributs
Exemples
Cette section fournit deux exemples de code. Le premier montre comment spécifier de manière déclarative des valeurs pour plusieurs propriétés de la AssemblyCollection classe. La deuxième montre comment utiliser des membres de la AssemblyCollection classe.
L’exemple de fichier de configuration suivant montre comment spécifier de manière déclarative des valeurs pour plusieurs propriétés de la 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>
L’exemple de code suivant montre comment utiliser des membres de la 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
Remarques
La AssemblyCollection classe ne fait référence à aucun élément réel dans le fichier de configuration sous-jacent. Il s’agit d’une construction qui permet d’accéder aux informations d’assembly qu’il contient.
Constructeurs
AssemblyCollection() |
Initialise une nouvelle instance de la classe AssemblyCollection. |
Propriétés
AddElementName |
Obtient ou définit le nom du ConfigurationElement à associer à l'opération d'ajout dans ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
ClearElementName |
Obtient ou définit le nom du ConfigurationElement à associer à l'opération d'effacement dans ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
CollectionType |
Obtient le type de ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
Count |
Obtient le nombre d’éléments de la collection. (Hérité de ConfigurationElementCollection) |
CurrentConfiguration |
Obtient une référence à l'instance Configuration de niveau supérieur qui représente la hiérarchie de configuration à laquelle l'instance ConfigurationElement actuelle appartient. (Hérité de ConfigurationElement) |
ElementInformation |
Obtient un objet ElementInformation qui contient les fonctionnalités et informations non personnalisables de l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
ElementName |
Obtient le nom utilisé pour identifier cette collection d'éléments dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
ElementProperty |
Obtient l'objet ConfigurationElementProperty qui représente l'objet ConfigurationElement lui-même. (Hérité de ConfigurationElement) |
EmitClear |
Obtient ou définit une valeur qui spécifie si la collection a été effacée. (Hérité de ConfigurationElementCollection) |
EvaluationContext |
Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
HasContext |
Obtient une valeur qui indique si la propriété CurrentConfiguration a la valeur |
IsSynchronized |
Obtient une valeur qui indique si l'accès à la collection est synchronisé. (Hérité de ConfigurationElementCollection) |
Item[ConfigurationProperty] |
Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement) |
Item[Int32] |
Obtient ou définit AssemblyInfo à l'index spécifié dans AssemblyCollection. |
Item[String] |
Obtient l'élément identifié par le nom d'assembly spécifié. |
LockAllAttributesExcept |
Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement) |
LockAllElementsExcept |
Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement) |
LockAttributes |
Obtient la collection d'attributs verrouillés. (Hérité de ConfigurationElement) |
LockElements |
Obtient la collection d'éléments verrouillés. (Hérité de ConfigurationElement) |
LockItem |
Obtient ou définit une valeur indiquant si l'élément est verrouillé. (Hérité de ConfigurationElement) |
Properties |
Obtient la collection de propriétés. (Hérité de ConfigurationElement) |
RemoveElementName |
Obtient ou définit le nom du ConfigurationElement à associer à l'opération de suppression dans ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
SyncRoot |
Obtient un objet utilisé pour synchroniser l'accès à ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
ThrowOnDuplicate |
Obtient une valeur indiquant si une tentative d'ajout d'un ConfigurationElement dupliqué à ConfigurationElementCollection provoquera la levée d'une exception. (Hérité de ConfigurationElementCollection) |
Méthodes
Add(AssemblyInfo) |
Ajoute un objet AssemblyInfo à la collection AssemblyCollection. |
BaseAdd(ConfigurationElement) |
Ajoute un élément de configuration à ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
BaseAdd(ConfigurationElement, Boolean) |
Ajoute un élément de configuration à la collection d'éléments de configuration. (Hérité de ConfigurationElementCollection) |
BaseAdd(Int32, ConfigurationElement) |
Ajoute un élément de configuration à la collection d'éléments de configuration. (Hérité de ConfigurationElementCollection) |
BaseClear() |
Supprime tous les objets d'élément de configuration de la collection. (Hérité de ConfigurationElementCollection) |
BaseGet(Int32) |
Obtient l'élément de configuration à l'emplacement d'index spécifié. (Hérité de ConfigurationElementCollection) |
BaseGet(Object) |
Retourne l'élément de configuration avec la clé spécifiée. (Hérité de ConfigurationElementCollection) |
BaseGetAllKeys() |
Retourne un tableau des clés pour tous les éléments de configuration contenus dans ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
BaseGetKey(Int32) |
Obtient la clé pour le ConfigurationElement à l'emplacement d'index spécifié. (Hérité de ConfigurationElementCollection) |
BaseIndexOf(ConfigurationElement) |
Indique l'index de l'élément ConfigurationElement spécifié. (Hérité de ConfigurationElementCollection) |
BaseIsRemoved(Object) |
Indique si l'élément ConfigurationElement avec la clé spécifiée a été supprimé de la collection ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
BaseRemove(Object) |
Supprime un ConfigurationElement de la collection. (Hérité de ConfigurationElementCollection) |
BaseRemoveAt(Int32) |
Supprime le ConfigurationElement à l'emplacement d'index spécifié. (Hérité de ConfigurationElementCollection) |
Clear() |
Efface tous les objets AssemblyInfo de la collection AssemblyCollection. |
CopyTo(ConfigurationElement[], Int32) |
Copie le contenu de ConfigurationElementCollection dans un tableau. (Hérité de ConfigurationElementCollection) |
CreateNewElement() |
En cas de substitution dans une classe dérivée, crée ConfigurationElement. (Hérité de ConfigurationElementCollection) |
CreateNewElement(String) |
Crée un nouveau ConfigurationElement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
DeserializeElement(XmlReader, Boolean) |
Lit du XML à partir du fichier de configuration. (Hérité de ConfigurationElement) |
Equals(Object) |
Compare ConfigurationElementCollection avec l'objet spécifié. (Hérité de ConfigurationElementCollection) |
GetElementKey(ConfigurationElement) |
Obtient la clé d'élément pour un élément de configuration spécifié en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
GetEnumerator() |
Obtient un IEnumerator utilisé pour itérer au sein de ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
GetHashCode() |
Obtient une valeur unique représentant l'instance de ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
GetTransformedAssemblyString(String) |
Retourne la version transformée du nom de l'assembly spécifié. (Hérité de ConfigurationElement) |
GetTransformedTypeString(String) |
Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Init() |
Rétablit l’état initial de l’objet ConfigurationElement. (Hérité de ConfigurationElement) |
InitializeDefault() |
Utilisé pour initialiser un jeu de valeurs par défaut pour l'objet ConfigurationElement. (Hérité de ConfigurationElement) |
IsElementName(String) |
Indique si le ConfigurationElement spécifié existe dans ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
IsElementRemovable(ConfigurationElement) |
Indique si l'élément ConfigurationElement spécifié peut être supprimée de la collection ConfigurationElementCollection. (Hérité de ConfigurationElementCollection) |
IsModified() |
Indique si cette ConfigurationElementCollection a été modifiée depuis son dernier enregistrement ou chargement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
IsReadOnly() |
Indique si l'objet ConfigurationElementCollection est en lecture seule. (Hérité de ConfigurationElementCollection) |
ListErrors(IList) |
Ajoute les erreurs de propriété non valide dans cet objet ConfigurationElement et dans tous les sous-éléments à la liste passée. (Hérité de ConfigurationElement) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Obtient une valeur indiquant si un attribut inconnu est rencontré pendant la désérialisation. (Hérité de ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Fait en sorte que le système de configuration lève une exception. (Hérité de ConfigurationElementCollection) |
OnRequiredPropertyNotFound(String) |
Lève une exception lorsqu'une propriété requise est introuvable. (Hérité de ConfigurationElement) |
PostDeserialize() |
Appelé après la désérialisation. (Hérité de ConfigurationElement) |
PreSerialize(XmlWriter) |
Appelé avant la sérialisation. (Hérité de ConfigurationElement) |
Remove(String) |
Supprime un objet AssemblyInfo de la collection AssemblyCollection. |
RemoveAt(Int32) |
Supprime un objet AssemblyInfo de la collection AssemblyCollection. |
Reset(ConfigurationElement) |
Réinitialise ConfigurationElementCollection à son état non modifié en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
ResetModified() |
Réinitialise la valeur de la propriété IsModified() à |
SerializeElement(XmlWriter, Boolean) |
Écrit les données de configuration d'un élément XML dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection) |
SerializeToXmlElement(XmlWriter, String) |
Écrit les balises extérieures de cet élément de configuration dans le fichier de configuration lorsqu'il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Affecte la valeur spécifiée à une propriété. (Hérité de ConfigurationElement) |
SetReadOnly() |
Définit la propriété IsReadOnly() pour l'objet ConfigurationElementCollection et pour tous les sous-éléments. (Hérité de ConfigurationElementCollection) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Inverse l'effet de la fusion des informations de configuration de différents niveaux de la hiérarchie de configuration. (Hérité de ConfigurationElementCollection) |
Implémentations d’interfaces explicites
ICollection.CopyTo(Array, Int32) |
Copie ConfigurationElementCollection dans un tableau. (Hérité de ConfigurationElementCollection) |
Méthodes d’extension
Cast<TResult>(IEnumerable) |
Effectue un cast des éléments d'un IEnumerable vers le type spécifié. |
OfType<TResult>(IEnumerable) |
Filtre les éléments d'un IEnumerable en fonction du type spécifié. |
AsParallel(IEnumerable) |
Active la parallélisation d'une requête. |
AsQueryable(IEnumerable) |
Convertit un IEnumerable en IQueryable. |