buildProviders-Element für compilation (ASP.NET-Einstellungsschema)
Aktualisiert: November 2007
Definiert eine Auflistung von Buildanbietern, die zum Kompilieren benutzerdefinierter Ressourcendateien verwendet werden.
<configuration>-Element
system.web-Element (ASP.NET-Einstellungsschema)
compilation-Element (ASP.NET-Einstellungsschema)
buildProviders-Element für compilation (ASP.NET-Einstellungsschema)
<buildProviders>
<add />
<clear/>
<remove />
</buildProviders>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.
Attribute
Keine.
Untergeordnete Elemente
Untertag |
Beschreibung |
|---|---|
add |
Optionales Element Fügt der Auflistung einen Buildanbieter hinzu. |
clear |
Optionales Element Entfernt alle Verweise auf geerbte Buildanbieter bis auf die vom aktuellen add-Element hinzugefügten Buildanbieter. |
remove |
Optionales Element Entfernt einen Verweis auf einen geerbten Buildanbieter aus der Auflistung. |
Ü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. |
Hinweise
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 buildProviders-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Es ist jedoch die Standardkonfiguration, die von der Anwendung zurückgegeben wird. Zur buildProviders-Auflistung der Web.config-Stammdatei werden Elemente hinzugefügt.
<buildProviders>
<clear />
</buildProviders>
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>
<buildProvider
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 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
compilation-Element (ASP.NET-Einstellungsschema)
add-Element für buildProviders für compilation (ASP.NET-Einstellungsschema)
clear-Element für buildProviders für compilation (ASP.NET-Einstellungsschema)
remove-Element für buildProviders für compilation (ASP.NET-Einstellungsschema)
assemblies-Element für compilation (ASP.NET-Einstellungsschema)
codeSubDirectories-Element für compilation (ASP.NET-Einstellungsschema)
compilers-Element für compilation (ASP.NET-Einstellungsschema)
expressionBuilders-Element für compilation (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen