add-Element für buildProviders für die Kompilierung (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 Buildanbieter hinzu.
Dieses Element ist neu in .NET Framework, Version 2.0.
<add
extension="custom resource file extension"
type="build provider type, build provider assembly" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
extension |
Erforderliches String-Attribut. Definiert die benutzerdefinierte Ressourcendateierweiterung. Dieses Attribut ist der Auflistungsschlüssel. Der Standardwert ist eine leere Zeichenfolge (""). |
type |
Erforderliches String-Attribut. Definiert den Typ und die Assembly zum Kompilieren der Dateien, die vom extension-Attribut angegeben werden. Der Standardwert ist eine leere Zeichenfolge (""). |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das Stammelement in jeder Konfigurationsdatei an, 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. |
buildProviders |
Definiert eine Auflistung von Buildanbietern, die zum Kompilieren benutzerdefinierter Ressourcendateien verwendet werden. |
Hinweise
Das add-Element fügt der Auflistung im buildproviders-Element einen Buildanbieter hinzu.
Das buildProviders-Element definiert eine Auflistung von Buildanbietern, die zum Kompilieren benutzerdefinierter Ressourcendateien eines bestimmten Dateityps und zum Generieren von Code während der Kompilierung verwendet werden.
Um benutzerdefinierte Buildaktionen für eine Datei innerhalb einer ASP.NET-Anwendung zu definieren, müssen Sie eine Klasse von der BuildProvider-Klasse ableiten, zum Erstellen des Dateityps Member in der abgeleiteten Klasse implementieren und den Buildanbieter für die entsprechende Dateierweiterung in der Anwendungskonfigurationsdatei konfigurieren. Weitere Informationen finden Sie unter BuildProvider.
Standardkonfiguration
Das folgende standardmäßige buildProviders-Element wird in der Web.config-Stammdatei konfiguriert.
<buildProviders>
<add extension=".aspx" type="System.Web.Compilation.PageBuildProvider" />
<add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider" />
<add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider" />
<add extension=".asix" type="System.Web.Compilation.ImageGeneratorBuildProvider" />
<add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider" />
<add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider" />
<add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider" />
<add extension=".resx" type="System.Web.Compilation.ResXBuildProvider" />
<add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider" />
<add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider" />
<add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>
<add extension=".js" type="System.Web.Compilation.ForceCopyBuildProvider" />
</buildProviders>
Beispiel
Das folgende Codebeispiel zeigt, wie Sie einen Buildanbieter definieren, der zum Kompilieren benutzerdefinierter Ressourcendateien mit der angegebenen Erweiterung verwendet wird.
<configuration>
<system.web>
<compilation>
<buildProviders>
<add
extension=".mafx"
type="MyBuildProviderType, MyBuildProviderAssembly"/>
</buildProviders>
</compilation>
</system.web>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
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 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
buildProviders-Element für die Kompilierung (ASP.NET-Einstellungsschema)
clear-Element für buildProviders 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)
Konzepte
ASP.NET Configuration File Hierarchy
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen