Freigeben über


TagPrefixAttribute-Klasse

Definiert das Tagpräfix, das in einer Webseite zum Bezeichnen benutzerdefinierter Steuerelemente verwendet wird. Diese Klasse kann nicht vererbt werden.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple:=True)> _
Public NotInheritable Class TagPrefixAttribute
    Inherits Attribute
'Usage
Dim instance As TagPrefixAttribute
[AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=true)] 
public sealed class TagPrefixAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Assembly, AllowMultiple=true)] 
public ref class TagPrefixAttribute sealed : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=true) */ 
public final class TagPrefixAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Assembly, AllowMultiple=true) 
public final class TagPrefixAttribute extends Attribute

Hinweise

Die TagPrefixAttribute-Klasse definiert ein Attribut auf Assemblyebene, das erforderlich ist, um Tagpräfixaliase für benutzerdefinierte Steuerelemente anzugeben. Mithilfe dieses Attributs generieren Tools wie Microsoft Visual Studio auf der ASP.NET-Seite, auf der die benutzerdefinierten Steuerelemente verwendet werden, automatisch eine Register-Direktive.

Diese Direktive registriert das Tagpräfix mit einem Namespace. Darüber hinaus gibt sie die Assembly an, in der sich die Codeimplementierung für das benutzerdefinierte Steuerelement befindet. Mithilfe dieser generierten Direktive können Sie benutzerdefinierte Steuerelemente in einer Webseite deklarativ verwenden.

Weitere Informationen über das Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Thema Position
Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Serversteuerelements Entwickeln von ASP.NET-Steuerelementen
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 1.1 Entwickeln von ASP.NET-Steuerelementen
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 2.0 Entwickeln von ASP.NET-Steuerelementen
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 2.0 Entwickeln von ASP.NET-Steuerelementen
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 1.1 Entwickeln von ASP.NET-Steuerelementen
Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Serversteuerelements Erstellen von Anwendungen mit Visual Web Developer
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 1.1 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 1.1 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 2.0 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 2.0 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 1.1 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Entwickeln von benutzerdefinierten datengebundenen Webserversteuerelementen für ASP.NET 2.0 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 2.0 Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten datengebundenen ASP.NET-Websteuerelements für ASP.NET 1.1 Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiel

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

<assembly: TagPrefix("CustomControls", "custom")> _

Namespace CustomControls
   
   ' Simple custom control
   Public Class MyVB_Control 
   Inherits Control
      Private message As String = "Hello"
      
      Public  Property getMessage() As String
         Get
            Return message
         End Get
         Set (ByVal value As String)
            message = value
         End Set
      End Property
      
      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub Render(writer As HtmlTextWriter)
         writer.Write(("<span style='background-color:aqua; font:8pt tahoma, verdana;'> " + Me.getMessage + "<br>" + "VB version. The time on the server is " + System.DateTime.Now.ToLongTimeString() + "</span>"))
      End Sub 'Render
   End Class 'MyControl
End Namespace 'CustomControls 
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

[assembly:TagPrefix("CustomControls", "custom")]


namespace CustomControls
{

    // Simple custom control
    public class MyCS_Control : Control
      {
            private String message = "Hello";
            
            public virtual String Message
            {
                  get
                  {
                        return message;
                  }
                  set
                  {
                        message = value;
                  }
            }
            
            [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
            protected override void Render( HtmlTextWriter writer)
            {
            writer.Write("<span style='background-color:aqua; font:8pt tahoma, verdana;'> "
                        + this.Message + "<br>" + "C# version. The time on the server is " + System.DateTime.Now.ToLongTimeString()
                        + "</span>");
                  
            }
      
      }

}
import System.*;
import System.Web.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;

/** @assembly TagPrefix("CustomControls", "custom")
 */
// Simple custom control
public class MyJSL_Control extends Control
{
    private String message = "Hello";

    /** @property 
     */
    public String get_Message()
    {
        return message;
    } //get_Message

    /** @property 
     */
    public void set_Message(String value)
    {
        message = value;
    } //set_Message

    protected void Render(HtmlTextWriter writer)
    {
        writer.Write("<span style='background-color:aqua; font:8pt"
            + " tahoma, verdana;'> " + this.get_Message() + "<br>"
            + "VJ# version. The time on the server is "
            + System.DateTime.get_Now().ToLongTimeString() + "</span>");
    } //Render
} //MyJSL_Control

Vererbungshierarchie

System.Object
   System.Attribute
    System.Web.UI.TagPrefixAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TagPrefixAttribute-Member
System.Web.UI-Namespace
Attribute

Weitere Ressourcen

@ Register
Syntax für benutzerdefinierte Serversteuerelemente