TagPrefixAttribute(String, String) Construtor

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Inicializa uma nova instância da classe TagPrefixAttribute.

public:
 TagPrefixAttribute(System::String ^ namespaceName, System::String ^ tagPrefix);

public TagPrefixAttribute (string namespaceName, string tagPrefix);

new System.Web.UI.TagPrefixAttribute : string * string -> System.Web.UI.TagPrefixAttribute

Public Sub New (namespaceName As String, tagPrefix As String)

Parâmetros

namespaceName

String

Uma cadeia de caracteres que identifica o namespace do controle personalizado.

tagPrefix

String

Uma cadeia de caracteres que identifica o prefixo do controle personalizado.

Exceções

ArgumentException

O namespaceName ou o tagPrefix é null ou uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir mostra como definir um atributo no nível do assembly que permite especificar um alias de prefixo de marca para um controle personalizado. Esse atributo é usado por ferramentas como Microsoft Visual Studio para gerar automaticamente uma @ Register diretiva em páginas da Web em que os controles personalizados são usados.

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>");
            }
      }
}

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
   End Class
End Namespace 'CustomControls

Comentários

Ao definir seu controle personalizado e antes de qualquer código, você deve invocar esse construtor de classe da seguinte maneira:

[assembly:TagPrefix(namespace, tag)]