Freigeben über


tagMapping-Element für pages (ASP.NET-Einstellungsschema)

Aktualisiert: November 2007

Definiert eine Auflistung von Tagtypen, die anderen Tagtypen zur Kompilierungszeit neu zugeordnet werden.

Dieses Element ist neu in .NET Framework, Version 2.0.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    pages-Element (ASP.NET-Einstellungsschema)
      tagMapping-Element für pages (ASP.NET-Einstellungsschema)

<tagMapping> 
   <add /> 
   <remove /> 
   <clear/>
</tagMapping>

Attribute und Elemente

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

Attribute

Keine

Untergeordnete Elemente

Element

Beschreibung

add

Optionales Element.

Fügt eine Tagzuordnung in die Auflistung der Tagzuordnungen hinzu, die während der Vorkompilierung verwendet werden.

clear

Optionales Element.

Entfernt alle Verweise auf geerbte Tagzuordnungen bis auf die vom aktuellen add-Element hinzugefügten Tagzuordnungen.

remove

Optionales Element.

Entfernt einen Verweis auf eine geerbte Tagzuordnung aus der Auflistung der Tagzuordnungen.

Übergeordnete Elemente

Element

Beschreibung

configuration

Gibt das erforderliche 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 die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

pages

Definiert seitenspezifische Konfigurationseinstellungen global, z. B. ASP.NET-Direktiven für Seiten und Steuerelemente innerhalb des Gültigkeitsbereichs der Konfigurationsdatei.

Hinweise

Das tagMapping-Element definiert eine Auflistung von Tagtypen, die anderen Tagtypen zur Kompilierungszeit neu zugeordnet werden. Diese Neuzuordnung führt dazu, dass der zugeordnete Typ anstelle des ursprünglichen Tagtyps in allen Seiten und Steuerelementen der ASP.NET-Anwendung im Gültigkeitsbereich der Konfigurationsdatei verwendet wird.

Tipp

Anders als bei anderen Attributen und Auflistungen im Seitenabschnitt hat die Neuzuordnung von Tags keine entsprechende ASP.NET-Seitendirektive.

Standardkonfiguration

Das folgende tagMapping-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.

   <tagMapping>
      <clear />
   </tagMapping>

Beispiel

Das folgende Codebeispiel zeigt, wie Sie für verschiedene Eigenschaften der TagMapInfo-Klasse Werte festlegen.

   <pages>
      <tagMapping>
         <add
            tagType=
               "System.Web.UI.WebControls.WebParts.WebPartManager"
            mappedTagType=
               "Microsoft.Sharepoint.WebPartPartManager, 
                MSPS.Web.dll, Version='2.0.0.0'" 
         />
      </tagMapping>
   </pages>

Elementinformationen

Konfigurationsabschnittshandler

PagesSection

Konfigurationsmember

TagMapping

TagMapCollection

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Web.config auf der Ebene virtueller oder physikalischer 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

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Konzepte

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Absichern der ASP.NET-Konfiguration

Referenz

pages-Element (ASP.NET-Einstellungsschema)

add-Element für tagMapping für pages (ASP.NET-Einstellungsschema)

clear-Element für tagMapping für pages (ASP.NET-Einstellungsschema)

remove-Element für tagMapping für pages (ASP.NET-Einstellungsschema)

namespaces-Element für pages (ASP.NET-Einstellungsschema)

controls-Element für pages (ASP.NET-Einstellungsschema)

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

configuration-Element (allgemeines Einstellungsschema)

@ Page

System.Configuration

System.Web.Configuration

TagMapping

TagMapCollection

PagesSection

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurations-API