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

Artikel
09/03/2008

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.

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

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen