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

Artikel
05/27/2012

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

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.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und ü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 sowie die 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 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" 
            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

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen