TagPrefixInfo Klas

Definitie

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

Overname

Object

ConfigurationElement

TagPrefixInfo

Voorbeelden

In dit voorbeeld ziet u hoe u waarden declaratief opgeeft voor verschillende kenmerken van de controls sectie, die ook kunnen worden geopend als leden van de TagPrefixInfo klasse.

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

In het volgende codevoorbeeld ziet u hoe u de TagPrefixInfo klasse gebruikt om instellingen voor tagvoorvoegsels programmatisch te wijzigen. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de PagesSection klasse.

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

Opmerkingen

Met de TagPrefixInfo klasse kunt u programmatisch toegang krijgen tot en informatie over tagvoorvoegsels wijzigen die zijn opgeslagen in een configuratiebestand. Het biedt dezelfde functionaliteit als de ASP.NET @Register richtlijn. Tagvoorvoegsels koppelen een 'naamruimte' in ASP.NET aan de assembly's en naamruimten die moeten worden opgenomen voor aangepaste besturingselementen en gebruikersbesturingselementen om correct te kunnen werken. TagPrefixInfo objecten worden opgeslagen als leden van een TagPrefixCollection object. Met TagPrefixCollection de klasse kunt u programmatisch toegang krijgen tot en de controls subsectie van de pages sectie van een configuratiebestand wijzigen.

TagPrefixInfo objecten worden aan de verzameling toegevoegd met behulp van het add element en het opgeven van een waarde voor het tagPrefix kenmerk, samen met waarden voor andere relevante kenmerken. De andere vereiste informatie varieert op basis van het type besturingselement dat u gaat gebruiken met het opgegeven tagvoorvoegsel:

• Als het een gebruikersbeheer is, moet u de TagPrefix, TagNameen Source eigenschappen definiëren.

• Als het een aangepast besturingselement is, moet u de TagPrefix, Namespaceen Assembly eigenschappen definiëren. De Assembly eigenschap is niet vereist als het besturingselement zich in de toepassingscodemap bevindt.

tagPrefix Dezelfde waarde kan worden gebruikt om aan meerdere assembly's of naamruimten toe te wijzen.

Zie ook

• PagesSection
• TagPrefixCollection