TagPrefixInfo Klass

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

Arv

Object

ConfigurationElement

TagPrefixInfo

Exempel

Det här exemplet visar hur du anger värden deklarativt för flera attribut i controls avsnittet, som också kan nås som medlemmar i TagPrefixInfo klassen.

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

Följande kodexempel visar hur du använder TagPrefixInfo klassen för att programmatiskt ändra taggprefixinställningar. Det här kodexemplet är en del av ett större exempel för PagesSection klassen.

// 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"))

Kommentarer

Med TagPrefixInfo klassen kan du programmatiskt komma åt och ändra information om taggprefix som lagras i en konfigurationsfil. Det ger samma funktioner som direktivet ASP.NET @Register. Taggprefix associerar ett "namnområde" i ASP.NET till de sammansättningar och namnområden som måste inkluderas för att anpassade kontroller och användarkontroller ska fungera korrekt. TagPrefixInfo objekt lagras som medlemmar i ett TagPrefixCollection objekt. Med TagPrefixCollection klassen kan du programmatiskt komma åt och ändra controls underavsnittet i pages avsnittet i en konfigurationsfil.

TagPrefixInfo objekt läggs till i samlingen med elementet add och anger ett värde för tagPrefix attributet tillsammans med värden för andra relevanta attribut. Den andra nödvändiga informationen varierar beroende på vilken typ av kontroll du ska använda med det angivna taggprefixet:

• Om det är en användarkontroll måste du definiera TagPrefixegenskaperna , TagNameoch Source .

• Om det är en anpassad kontroll måste du definiera TagPrefixegenskaperna , Namespaceoch Assembly . Egenskapen Assembly krävs inte om kontrollen finns i programkodkatalogen.

Samma tagPrefix värde kan användas för att mappa till flera sammansättningar eller namnområden.

Se även

• PagesSection
• TagPrefixCollection