Freigeben über

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

  • Artikel

Aktualisiert: November 2007

Definiert eine Auflistung von Register-Direktiven sowie die Namespaces, in denen sich die Tagpräfixe befinden.

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)
      controls-Element für pages (ASP.NET-Einstellungsschema)

<controls> 
   <add /> 
</controls>

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 ein Tagpräfix in die Auflistung der Tagpräfixe hinzu, die während der Vorkompilierung verwendet werden.

Ü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 controls-Element definiert eine Auflistung von Register-Direktiven sowie die Namespaces, in denen sich Tagpräfixe befinden. Dieses Element entspricht der @ Register-Direktive auf einer ASP.NET-Seite. Mit der @ Register-Direktive können Sie das Tagpräfix für ein Benutzersteuerelement festlegen.

Tagpräfixe ordnen in ASP.NET einen Namespace den Assemblys und Namespaces zu, die für das korrekte Funktionieren von COM-Steuerelementen und Benutzersteuerelementen mit eingebunden werden müssen. Die folgenden Informationen sind für die Konfiguration des controls-Elements von Nutzen:

  • Bei der Anwendung auf ein Benutzersteuerelement müssen Sie die Attribute tagPrefix, tagName und source des untergeordneten Elements add festlegen.

  • Bei der Anwendung auf ein benutzerdefiniertes Steuerelement müssen Sie die Attribute tagPrefix, namespace und assembly des untergeordneten Elements add festlegen. Das assembly-Attribut ist nicht erforderlich, wenn sich das Steuerelement im Anwendungscodeverzeichnis befindet.

Sie können für die Zuordnung zu mehreren Assemblys oder Namespaces den gleichen tagPrefix-Wert verwenden.

Standardkonfiguration

Das folgende standardmäßige controls-Element wird in der Web.config-Stammdatei konfiguriert.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

Beispiel

Das folgende Codebeispiel veranschaulicht, wie Werte für verschiedene Attribute des controls-Elements deklarativ festgelegt werden können. Auf sie kann auch programmgesteuert als Member der TagPrefixInfo-Klasse zugegriffen werden.

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Elementinformationen

Konfigurationsabschnittshandler

PagesSection

Konfigurationsmember

Controls

TagPrefixCollection

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

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 controls für pages (ASP.NET-Einstellungsschema)

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

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

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

configuration-Element (allgemeines Einstellungsschema)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurations-API