ConstructorNeedsTagAttribute Constructor (Boolean)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the ConstructorNeedsTagAttribute class.

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

public ConstructorNeedsTagAttribute(
	bool needsTag


Type: System.Boolean

true to add a tag to a control; otherwise, false.

The following code example creates a simple custom control whose tag name is defined at run time. The following is the command line used to build the executable.

csc /t:library /out:myWebAppPath/Bin/cs_myConstructorNeedsTagAtt.dll constructorNeedsTagAtt.cs
/* File Name: constructorneedstagatt.cs. */

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;

namespace MyUserControl 
  // Attach the 'ConstructorNeedsTagAttribute' to 'Simple' class. 
  public class Simple : WebControl 
    private String NameTag = "";

    public Simple(String tag)
      this.NameTag = tag;

    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
    protected override void Render(HtmlTextWriter output) 
      output.Write("<br>The TagName used for the 'Simple' control is "+"'"+NameTag+"'");

The following code example uses the previous custom control. Notice that the values shown in the Register directive reflect the previous command line.

<%@ Register TagPrefix='MyCurrentUserControl' Namespace='MyUserControl' Assembly='cs_myConstructorNeedsTagAtt'%>
  <form method="POST" runat="server">
  <MyCurrentUserControl:Simple runat="server" />

.NET Framework
Available since 1.1
Return to top