TagPrefixInfo Classe

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Definisce un elemento di configurazione contenente informazioni correlate ai tag.

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

Ereditarietà

Object

ConfigurationElement

TagPrefixInfo

Esempio

In questo esempio viene illustrato come specificare i valori in modo dichiarativo per diversi attributi della controls sezione, a cui è anche possibile accedere come membri della TagPrefixInfo classe .

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

Nell'esempio di codice seguente viene illustrato come usare la TagPrefixInfo classe per modificare a livello di codice le impostazioni del prefisso dei tag. Questo esempio di codice fa parte di un esempio più ampio fornito per la PagesSection classe .

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

Commenti

La TagPrefixInfo classe consente di accedere e modificare a livello di codice le informazioni sui prefissi tag archiviate in un file di configurazione. Fornisce la stessa funzionalità della direttiva ASP.NET @Register . I prefissi tag associano uno "spazio dei nomi" in ASP.NET agli assembly e agli spazi dei nomi che devono essere inclusi per il corretto funzionamento dei controlli personalizzati e dei controlli utente. TagPrefixInfo gli oggetti vengono archiviati come membri di un TagPrefixCollection oggetto . La TagPrefixCollection classe consente di accedere e modificare a livello di codice la controls sottosezione della pages sezione di un file di configurazione.

TagPrefixInfo gli oggetti vengono aggiunti alla raccolta utilizzando l'elemento add e specificando un valore per l'attributo tagPrefix insieme ai valori per altri attributi pertinenti. Le altre informazioni necessarie variano in base al tipo di controllo che verrà usato con il prefisso del tag specificato:

• Se si tratta di un controllo utente, è necessario definire le TagPrefixproprietà , TagNamee Source .

• Se si tratta di un controllo personalizzato, è necessario definire le TagPrefixproprietà , Namespacee Assembly . La Assembly proprietà non è necessaria se il controllo si trova nella directory del codice dell'applicazione.

Lo stesso tagPrefix valore può essere usato per eseguire il mapping a più assembly o spazi dei nomi.

Annotazioni

Quando si specifica un'origine, il controllo utente stesso non deve trovarsi nella stessa directory della pagina. In caso affermativo, viene visualizzato un errore di run-time quando si tenta di caricare la pagina.

Costruttori

Nome	Descrizione
TagPrefixInfo(String, String, String, String, String)	Inizializza una nuova istanza della TagPrefixInfo classe utilizzando i valori passati.

Proprietà

Nome	Descrizione
Assembly	Ottiene o imposta il nome dell'assembly contenente l'implementazione del controllo.
CurrentConfiguration	Ottiene un riferimento all'istanza di primo livello Configuration che rappresenta la gerarchia di configurazione a cui appartiene l'istanza corrente ConfigurationElement . (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un ElementInformation oggetto che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement . (Ereditato da ConfigurationElement)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la CurrentConfiguration proprietà è null. (Ereditato da ConfigurationElement)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene o imposta una proprietà, un attributo o un elemento figlio di questo elemento di configurazione. (Ereditato da ConfigurationElement)
LockAllAttributesExcept	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Namespace	Ottiene o imposta lo spazio dei nomi in cui risiede il controllo.
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
Source	Ottiene o imposta il nome e il percorso del file contenente il controllo utente.
TagName	Ottiene o imposta il nome del controllo utente.
TagPrefix	Ottiene o imposta il prefisso del tag associato a un file di origine o a uno spazio dei nomi e un assembly.

Metodi

Nome	Descrizione
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta questa istanza con un altro oggetto .
GetHashCode()	Restituisce un valore hash per l'istanza corrente.
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome dell'assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Init()	Imposta l'oggetto ConfigurationElement sullo stato iniziale. (Ereditato da ConfigurationElement)
InitializeDefault()	Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement . (Ereditato da ConfigurationElement)
IsModified()	Indica se questo elemento di configurazione è stato modificato dopo l'ultimo salvataggio o caricamento, se implementato in una classe derivata. (Ereditato da ConfigurationElement)
IsReadOnly()	Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement)
ListErrors(IList)	Aggiunge gli errori di proprietà non validi in questo ConfigurationElement oggetto e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ottiene un valore che indica se durante la deserializzazione viene rilevato un elemento sconosciuto. (Ereditato da ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement)
PostDeserialize()	Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Chiamato prima della serializzazione. (Ereditato da ConfigurationElement)
Reset(ConfigurationElement)	Reimposta lo stato interno dell'oggetto ConfigurationElement , inclusi i blocchi e gli insiemi di proprietà. (Ereditato da ConfigurationElement)
ResetModified()	Reimposta il valore del IsModified() metodo su false quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Scrive il contenuto di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la IsReadOnly() proprietà per l'oggetto ConfigurationElement e tutti i sottoelementi. (Ereditato da ConfigurationElement)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica l'oggetto ConfigurationElement per rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement)

Vedi anche

• PagesSection
• TagPrefixCollection