Freigeben über

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

  • Artikel

Aktualisiert: November 2007

Fügt ein Tagpräfix in die Auflistung der Tagpräfixe hinzu, die während der Vorkompilierung verwendet 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)
      controls-Element für pages (ASP.NET-Einstellungsschema)
        add-Element für controls für pages (ASP.NET-Einstellungsschema)

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

assembly

Optionales String-Attribut.

Gibt den Namen der Assembly an, die die Implementierung des COM-Steuerelements enthält. Dieses Attribut macht erforderlich, dass auch das namespace-Attribut festgelegt wird.

namespace

Optionales String-Attribut.

Gibt den Namespace an, der dem Tagpräfix zugeordnet ist. Zusätzlich erfordert dieses Attribut, dass auch das assembly-Attribut festgelegt ist, wenn sich das COM-Steuerelement in einem anderen Verzeichnis als der Anwendungscode befindet.

src

Optionales String-Attribut.

Gibt den Namen der Datei an, die das Benutzersteuerelement enthält. Zusätzlich erfordert dieses Attribut, dass auch das tagName-Attribut festgelegt wird.

tagName

Optionales String-Attribut.

Gibt den Namen des in der Seite zu verwendenden Steuerelements an. Zusätzlich erfordert dieses Attribut, dass auch das src-Attribut festgelegt wird.

tagPrefix

Erforderliches String-Attribut.

Gibt das Tagpräfix an, das einer Quelldatei oder einem Namespace und einer Assembly zugeordnet ist. Dieses Attribut erfordert eine der folgenden Kombinationen anderer Attribute:

  • namespace zur Definition eines COM-Steuerelements, wenn sich das Steuerelement im Verzeichnis mit dem Anwendungscode befindet.

  • namespace und assembly zur Definition eines COM-Steuerelements.

  • tagName und src zur Definition eines Benutzersteuerelements.

Geerbte Attribute

Optionale Attribute.

Attribute, die von allen Abschnittselementen geerbt werden.

Untergeordnete Elemente

Keine.

Ü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 (z. B. globale ASP.NET-Direktiven) für Seiten und Steuerelemente innerhalb des Gültigkeitsbereichs der Konfigurationsdatei.

controls

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

Hinweise

Das add-Element fügt der Auflistung von Tagpräfixen im controls-Element, die während der Vorkompilierung verwendet werden, ein Tagpräfix hinzu.

Das controls-Element definiert eine Auflistung von Register-Direktiven und 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 einen Namespace in ASP.NET 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 ist 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 auf 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" 
            src="controls/MyControl.ascx"/>
      </controls>
   </pages>

Elementinformationen

Konfigurationsabschnittshandler

PagesSection

Konfigurationsmember

Add

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 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

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

pages-Element (ASP.NET-Einstellungsschema)

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

configuration-Element (allgemeines Einstellungsschema)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

Add

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurations-API