Share via

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

  • Artikel

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

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.

<controls> 
   <add /> 
</controls>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und ü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 controls-Standardelement wird in der Stammdatei Web.config 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

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

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

Konzepte

ASP.NET Configuration File Hierarchy

Securing Configuration

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Configuring ASP.NET Applications

ASP.NET Configuration API