Freigeben über


add-Element für zu kompilierende Assemblys (ASP.NET-Einstellungsschema)

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Fügt der Auflistung einen Assemblyverweis hinzu.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und ü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

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referenz

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

clear-Element für Assemblys für die Kompilierung (ASP.NET-Einstellungsschema)

remove-Element für zu kompilierende Assemblys (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

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

compilation-Element (ASP.NET-Einstellungsschema)

CompilationSection

System.Configuration

System.Web.Configuration

Konzepte

ASP.NET Compilation Model

ASP.NET Web Page Syntax Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API