ConstructorNeedsTagAttribute Constructor (Boolean)

 

Initializes a new instance of the ConstructorNeedsTagAttribute class.

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

public ConstructorNeedsTagAttribute(
	bool needsTag
)

Parameters

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. 
  [ConstructorNeedsTagAttribute(true)]
  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'%>
 <html>
  <body>
  <form method="POST" runat="server">
  <MyCurrentUserControl:Simple runat="server" />
  </form>
  </body>
 </html>

.NET Framework
Available since 1.1
Return to top
Show: