TagPrefixInfo Klasse

Definition

public ref class TagPrefixInfo sealed : System::Configuration::ConfigurationElement

public sealed class TagPrefixInfo : System.Configuration.ConfigurationElement

type TagPrefixInfo = class
    inherit ConfigurationElement

Public NotInheritable Class TagPrefixInfo
Inherits ConfigurationElement

Vererbung

Object

ConfigurationElement

TagPrefixInfo

Beispiele

In diesem Beispiel wird veranschaulicht, wie Werte deklarativ für mehrere Attribute des controls Abschnitts angegeben werden, auf die auch als Mitglieder der TagPrefixInfo Klasse zugegriffen werden kann.

<system.web>  
  <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="MyControl.ascx"/>  
    </controls>  
   </pages>  
</system.web>  

Im folgenden Codebeispiel wird gezeigt, wie Die Klasse zum programmgesteuerten Ändern von TagPrefixInfo Tagpräfixeinstellungen verwendet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die PagesSection Klasse bereitgestellt wird.

// Get all current Controls in the collection.
for (int i = 0; i < pagesSection.Controls.Count; i++)
{
  Console.WriteLine("Control {0}:", i);
  Console.WriteLine("  TagPrefix = '{0}' ",
      pagesSection.Controls[i].TagPrefix);
  Console.WriteLine("  TagName = '{0}' ",
      pagesSection.Controls[i].TagName);
  Console.WriteLine("  Source = '{0}' ",
      pagesSection.Controls[i].Source);
  Console.WriteLine("  Namespace = '{0}' ",
      pagesSection.Controls[i].Namespace);
  Console.WriteLine("  Assembly = '{0}' ",
      pagesSection.Controls[i].Assembly);
}

// Create a new TagPrefixInfo object.
System.Web.Configuration.TagPrefixInfo tagPrefixInfo =
    new System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx");

// Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo);

// Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add(
    new System.Web.Configuration.TagPrefixInfo(
    "MyCtrl", "MyNameSpace", "MyAssembly", "MyControl",
    "MyControl.ascx"));

' Get all current Controls in the collection.
Dim j As Int32
For j = 0 To pagesSection.Controls.Count - 1
  Console.WriteLine("Control {0}:", j)
  Console.WriteLine("  TagPrefix = '{0}' ", _
   pagesSection.Controls(j).TagPrefix)
  Console.WriteLine("  TagName = '{0}' ", _
   pagesSection.Controls(j).TagName)
  Console.WriteLine("  Source = '{0}' ", _
   pagesSection.Controls(j).Source)
  Console.WriteLine("  Namespace = '{0}' ", _
   pagesSection.Controls(j).Namespace)
  Console.WriteLine("  Assembly = '{0}' ", _
   pagesSection.Controls(j).Assembly)
Next

' Create a new TagPrefixInfo object.
Dim tagPrefixInfo As System.Web.Configuration.TagPrefixInfo = _
 New System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx")

' Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo)

' Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add( _
 New System.Web.Configuration.TagPrefixInfo( _
 "MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", _
 "MyControl.ascx"))

Hinweise

Mit der TagPrefixInfo Klasse können Sie programmgesteuert auf Tagpräfixinformationen zugreifen und ändern, die in einer Konfigurationsdatei gespeichert sind. Er stellt dieselbe Funktionalität wie die ASP.NET-Direktive @Register bereit. Tagpräfixe ordnen einen "Namespace" in ASP.NET den Assemblys und Namespaces zu, die für benutzerdefinierte Steuerelemente und Benutzersteuerelemente enthalten sein müssen, um ordnungsgemäß zu funktionieren. TagPrefixInfo Objekte werden als Elemente eines TagPrefixCollection Objekts gespeichert. Mit der TagPrefixCollection Klasse können Sie programmgesteuert auf den pages Abschnitt einer Konfigurationsdatei zugreifen und änderncontrols.

TagPrefixInfo Objekte werden der Auflistung mithilfe des Elements hinzugefügt und geben einen Wert für das add tagPrefix Attribut zusammen mit Werten für andere relevante Attribute an. Die anderen erforderlichen Informationen variieren je nach Art des Steuerelements, das Sie mit dem angegebenen Tagpräfix verwenden:

• Wenn es sich um ein Benutzersteuerelement handelt, müssen Sie die TagPrefixEigenschaften TagNameund Source Die Eigenschaften definieren.

• Wenn es sich um ein benutzerdefiniertes Steuerelement handelt, müssen Sie die TagPrefixNamespaceEigenschaften und Assembly Eigenschaften definieren. Die Assembly Eigenschaft ist nicht erforderlich, wenn sich das Steuerelement im Anwendungscodeverzeichnis befindet.

Derselbe tagPrefix Wert kann verwendet werden, um mehreren Assemblys oder Namespaces zuzuordnen.

Konstruktoren

Eigenschaften

Methoden

Gilt für

Siehe auch

• PagesSection
• TagPrefixCollection