AssemblyCollection Klasse

Referenz

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von AssemblyInfo-Objekten dar. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

ConfigurationElement

ConfigurationElementCollection
AssemblyCollection

Attribute: ConfigurationCollectionAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Wird veranschaulicht, wie Werte für mehrere Eigenschaften der AssemblyCollection Klasse deklarativ angegeben werden. Im zweiten Wird veranschaulicht, wie Mitglieder der AssemblyCollection Klasse verwendet werden.

Das folgende Konfigurationsdateibeispiel zeigt, wie Werte für mehrere Eigenschaften der AssemblyCollection Klasse deklarativ angegeben werden.

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

Im folgenden Codebeispiel wird veranschaulicht, wie Member der AssemblyCollection Klasse verwendet werden.

#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

Hinweise

Die AssemblyCollection Klasse verweist nicht auf ein tatsächliches Element in der zugrunde liegenden Konfigurationsdatei. Es handelt sich um ein Konstrukt, das den Zugriff auf die enthaltenen Assemblyinformationen ermöglicht.

Konstruktoren

AssemblyCollection()

Initialisiert eine neue Instanz der AssemblyCollection-Klasse.

Eigenschaften

AddElementName	Ruft den Namen des ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Hinzufügevorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Geerbt von ConfigurationElementCollection)
ClearElementName	Ruft den Namen für das ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Löschvorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Geerbt von ConfigurationElementCollection)
CollectionType	Ruft den Typ des ConfigurationElementCollection ab. (Geerbt von ConfigurationElementCollection)
Count	Ruft die Anzahl der Elemente in der Auflistung ab. (Geerbt von ConfigurationElementCollection)
CurrentConfiguration	Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört. (Geerbt von ConfigurationElement)
ElementInformation	Ruft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält. (Geerbt von ConfigurationElement)
ElementName	Ruft den Namen ab, der beim Überschreiben in einer abgeleiteten Klasse für die Identifikation dieser Auflistung mit Elementen in der Konfigurationsdatei verwendet wird. (Geerbt von ConfigurationElementCollection)
ElementProperty	Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EmitClear	Ruft einen Wert ab, der angibt, ob die Auflistung gelöscht wurde, oder legt diesen fest. (Geerbt von ConfigurationElementCollection)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration-Eigenschaft `null` ist. (Geerbt von ConfigurationElement)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist. (Geerbt von ConfigurationElementCollection)
Item[ConfigurationProperty]	Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Geerbt von ConfigurationElement)
Item[Int32]	Ruft den AssemblyInfo am angegebenen Index in der AssemblyCollection ab oder legt diesen fest.
Item[String]	Ruft das durch den angegebenen Assemblynamen bezeichnete Element ab.
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest. (Geerbt von ConfigurationElement)
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
RemoveElementName	Ruft den Namen des ConfigurationElement ab, das beim Überschreiben in einer abgeleiteten Klasse dem Entfernungsvorgang in der ConfigurationElementCollection zugeordnet werden soll, oder legt diesen fest. (Geerbt von ConfigurationElementCollection)
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf ConfigurationElementCollection verwendet wird. (Geerbt von ConfigurationElementCollection)
ThrowOnDuplicate	Ruft einen Wert ab, der angibt, ob der Versuch, der ConfigurationElement ein doppeltes ConfigurationElementCollection hinzuzufügen, eine Ausnahme auslöst. (Geerbt von ConfigurationElementCollection)

Methoden

Add(AssemblyInfo)	Fügt der AssemblyCollection-Auflistung ein AssemblyInfo-Objekt hinzu.
BaseAdd(ConfigurationElement)	Fügt der ConfigurationElementCollection ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Fügt der Konfigurationselementauflistung ein Konfigurationselement hinzu. (Geerbt von ConfigurationElementCollection)
BaseClear()	Entfernt alle Konfigurationselementobjekte aus der Auflistung. (Geerbt von ConfigurationElementCollection)
BaseGet(Int32)	Ruft das Konfigurationselement am angegebenen Index ab. (Geerbt von ConfigurationElementCollection)
BaseGet(Object)	Gibt das Konfigurationselement mit dem angegebenen Schlüssel zurück. (Geerbt von ConfigurationElementCollection)
BaseGetAllKeys()	Gibt ein Array der Schlüssel für alle Konfigurationselemente in der ConfigurationElementCollection zurück. (Geerbt von ConfigurationElementCollection)
BaseGetKey(Int32)	Ruft den Schlüssel für das ConfigurationElement an der angegebenen Indexposition ab. (Geerbt von ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Gibt den Index der angegebenen ConfigurationElement an. (Geerbt von ConfigurationElementCollection)
BaseIsRemoved(Object)	Gibt an, ob das ConfigurationElement mit dem angegebenen Schlüssel aus der ConfigurationElementCollection entfernt worden ist. (Geerbt von ConfigurationElementCollection)
BaseRemove(Object)	Entfernt ein ConfigurationElement-Objekt aus der Auflistung. (Geerbt von ConfigurationElementCollection)
BaseRemoveAt(Int32)	Entfernt das ConfigurationElement an der angegebenen Indexposition. (Geerbt von ConfigurationElementCollection)
Clear()	Löscht alle AssemblyInfo-Objekte aus der AssemblyCollection-Auflistung.
CopyTo(ConfigurationElement[], Int32)	Kopiert den Inhalt der ConfigurationElementCollection in ein Array. (Geerbt von ConfigurationElementCollection)
CreateNewElement()	Erstellt beim Überschreiben in einer abgeleiteten Klasse einen neuen ConfigurationElement. (Geerbt von ConfigurationElementCollection)
CreateNewElement(String)	Erstellt ein neues ConfigurationElement, wenn es in einer abgeleiteten Klasse überschrieben wurde. (Geerbt von ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die ConfigurationElementCollection mit dem angegebenen Objekt. (Geerbt von ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ruft beim Überschreiben in einer abgeleiteten Klasse den Elementschlüssel für ein angegebenes Konfigurationselement ab. (Geerbt von ConfigurationElementCollection)
GetEnumerator()	Ruft einen IEnumerator ab, der zum Durchlaufen von ConfigurationElementCollection verwendet wird. (Geerbt von ConfigurationElementCollection)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die ConfigurationElementCollection-Instanz darstellt. (Geerbt von ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt für das ConfigurationElement-Objekt den Ausgangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsElementName(String)	Gibt an, ob das angegebene ConfigurationElement in der ConfigurationElementCollection vorhanden ist. (Geerbt von ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Gibt an, ob das angegebene ConfigurationElement aus der ConfigurationElementCollection entfernt werden kann. (Geerbt von ConfigurationElementCollection)
IsModified()	Gibt an, ob diese ConfigurationElementCollection geändert wurde, seit sie zuletzt gespeichert oder geladen wurde, wenn sie in einer abgeleiteten Klasse überschrieben wurde. (Geerbt von ConfigurationElementCollection)
IsReadOnly()	Gibt an, ob das ConfigurationElementCollection-Objekt schreibgeschützt ist. (Geerbt von ConfigurationElementCollection)
ListErrors(IList)	Fügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Bewirkt, dass das Konfigurationssystem eine Ausnahme auslöst. (Geerbt von ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Remove(String)	Entfernt ein AssemblyInfo-Objekt aus der AssemblyCollection-Auflistung.
RemoveAt(Int32)	Entfernt ein AssemblyInfo-Objekt aus der AssemblyCollection-Auflistung.
Reset(ConfigurationElement)	Setzt die ConfigurationElementCollection auf ihren unveränderten Zustand zurück, wenn sie in einer abgeleiteten Klasse überschrieben wurde. (Geerbt von ConfigurationElementCollection)
ResetModified()	Setzt den Wert der IsModified()-Eigenschaft auf `false` zurück, wenn er in einer abgeleiteten Klasse überschrieben wurde. (Geerbt von ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Schreibt die Konfigurationsdaten in ein XML-Element in der Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse überschrieben wurden. (Geerbt von ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly()-Eigenschaft für das ConfigurationElementCollection-Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElementCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Kehrt die Auswirkungen der Zusammenführung von Konfigurationsinformationen aus verschiedenen Ebenen der Konfigurationshierarchie um. (Geerbt von ConfigurationElementCollection)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)

Kopiert das ConfigurationElementCollection in ein Array.

(Geerbt von ConfigurationElementCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für

Freigeben über