Freigeben über


add-Element für assemblies für compilation (ASP.NET-Einstellungsschema)

Aktualisiert: November 2007

Fügt der Auflistung einen Assemblyverweis hinzu.

<configuration>-Element
  system.web-Element (ASP.NET-Einstellungsschema)
    compilation-Element (ASP.NET-Einstellungsschema)
      assemblies-Element für compilation (ASP.NET-Einstellungsschema)
        add-Element für assemblies für compilation (ASP.NET-Einstellungsschema)

<add 
   assembly="Assembly 
             [,Version=version number] 
             [,Culture=culture] 
             [,PublicKeyToken=token]"
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

assembly

Erforderliches String-Attribut.

Gibt eine durch Trennzeichen getrennte Assemblykombination an, die aus Versions-, Kultur- und öffentlichen Schlüsseltoken besteht. ASP.NET sucht zunächst im privaten Verzeichnis Bin der Anwendung und anschließend im Assemblycache des Systems nach der Assembly-DLL.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.web

Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

compilation

Konfiguriert alle Kompilierungseinstellungen, die ASP.NET zur Kompilierung von Anwendungen verwendet.

assemblies

Definiert eine Auflistung von Assemblynamen, die während der Kompilierung einer ASP.NET-Anwendung verwendet werden.

Hinweise

Das add-Element fügt während der Kompilierung einer dynamischen Ressource einen Assemblyverweis hinzu. Beim Kompilieren der einzelnen Codemodule verknüpft ASP.NET diese Assembly automatisch mit der Ressource.

Der Wert des add-Elements ist kein DLL-Pfad, sondern ein Assemblyname. ASP.NET sucht nach dem Assemblynamen, um den physischen Speicherort der DLL zu ermitteln. Optional können Sie das Platzhalterzeichen (*) angeben, um jede Assembly innerhalb des privaten Assemblycaches einer Anwendung hinzuzufügen. Der Assemblycache befindet sich entweder im Unterverzeichnis \bin einer Anwendung oder im Installationsverzeichnis von .NET Framework (%systemroot%\Microsoft.NET\Framework\Version\). Ausführliche Informationen finden Sie unter Load.

Standardkonfiguration

Das folgende standardmäßige assemblies-Element wird in der Web.config-Stammdatei konfiguriert.

<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="*" />
</assemblies>

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie einer Anwendung ein Assemblyverweis hinzugefügt wird.

<configuration>
   <system.web>
      <compilation>
         <assemblies>
            <add assembly="System.Data, Version=1.0.2411.0, 
                           Culture=neutral, 
                           PublicKeyToken=b77a5c561934e089"/>
         </assemblies>
      </compilation>
   </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler

CompilationSection

Konfigurationsmember

Add

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Web.config auf der Ebene virtueller oder physischer Verzeichnisse

Anforderungen

Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0

.NET Framework, Version 1.0, 1.1 oder 2.0

Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Konzepte

Übersicht über die ASP.NET-Kompilierung

Übersicht über die Syntax von ASP.NET-Webseiten

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Referenz

assemblies-Element für compilation (ASP.NET-Einstellungsschema)

clear-Element für assemblies für compilation (ASP.NET-Einstellungsschema)

remove-Element für assemblies für compilation (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

system.web-Element (ASP.NET-Einstellungsschema)

compilation-Element (ASP.NET-Einstellungsschema)

CompilationSection

System.Configuration

System.Web.Configuration

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurations-API