TagPrefixInfo Klasse

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Definiert ein Konfigurationselement, das tagbezogene Informationen enthält.

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 Member 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 Sie die Klasse zum programmgesteuerten Ändern von TagPrefixInfo Tagpräfixeinstellungen verwenden. 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 diese ändern, die in einer Konfigurationsdatei gespeichert sind. Sie stellt die gleiche Funktionalität wie die ASP.NET-Direktive bereit @Register . Tagpräfixe ordnen einen "Namespace" in ASP.NET den Assemblys und Namespaces zu, die für benutzerdefinierte Steuerelemente und Benutzersteuerelemente enthalten sein müssen, damit sie ordnungsgemäß funktionieren. TagPrefixInfo Objekte werden als Elemente eines TagPrefixCollection Objekts gespeichert. Mit der TagPrefixCollection Klasse können Sie programmgesteuert auf den controls Unterabschnitt des pages Abschnitts einer Konfigurationsdatei zugreifen und diese ändern.

TagPrefixInfo objekte werden der Auflistung mithilfe des add Elements hinzugefügt und geben einen Wert für das 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 werden:

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

• Wenn es sich um ein benutzerdefiniertes Steuerelement handelt, müssen Sie die TagPrefixEigenschaften Namespaceund Eigenschaften Assembly 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.

Hinweis

Wenn eine Quelle angegeben wird, darf sich das Benutzersteuerelement selbst nicht im selben Verzeichnis wie die Seite befinden. Wenn dies der Fehler ist, erhalten Sie einen Laufzeitfehler, wenn Sie versuchen, die Seite zu laden.

Konstruktoren

Name	Beschreibung
TagPrefixInfo(String, String, String, String, String)	Initialisiert eine neue Instanz der TagPrefixInfo Klasse mithilfe der übergebenen Werte.

Eigenschaften

Name	Beschreibung
Assembly	Dient zum Abrufen oder Festlegen des Namens der Assembly, die die Steuerelementimplementierung enthält.
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
ElementInformation	Ruft ein ElementInformation Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty Objekt ab, das das ConfigurationElement Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration Eigenschaft ist null. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
Namespace	Dient zum Abrufen oder Festlegen des Namespaces, in dem sich das Steuerelement befindet.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Source	Ruft den Namen und Pfad der Datei ab, die das Benutzersteuerelement enthält, oder legt diesen fest.
TagName	Dient zum Abrufen oder Festlegen des Namens des Benutzersteuerelements.
TagPrefix	Ruft ab oder legt das Tagpräfix, das einer Quelldatei oder namespace und Assembly zugeordnet ist.

Methoden

Name	Beschreibung
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht diese Instanz mit einem anderen Objekt.
GetHashCode()	Gibt einen Hashwert für die aktuelle Instanz zurück.
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement Objekt auf seinen Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Gibt an, ob dieses Konfigurationselement seit dem letzten Speichern oder Laden geändert wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Zustand des ConfigurationElement Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt den Wert der IsModified() Methode zurück, wenn false sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei, wenn es in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly() Eigenschaft für das ConfigurationElement Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)

Weitere Informationen

• PagesSection
• TagPrefixCollection