WebControl Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the WebControl class.
Overloads
WebControl() |
Initializes a new instance of the WebControl class that represents a |
WebControl(String) |
Initializes a new instance of the WebControl class using the specified HTML tag. |
WebControl(HtmlTextWriterTag) |
Initializes a new instance of the WebControl class using the specified HTML tag. |
WebControl()
Initializes a new instance of the WebControl class that represents a Span
HTML tag.
protected:
WebControl();
protected WebControl ();
Protected Sub New ()
Remarks
This constructor is used to initialize a new instance of the WebControl class that represents a Span
HTML element.
The following table shows the initial property value for an instance of WebControl.
Property | Initial Value |
---|---|
TagKey |
The Span enumeration value. |
Note
This constructor is not called directly. Instead, it is often called by the constructor of a derived class to initialize the TagKey property to the Span enumeration value.
See also
Applies to
WebControl(String)
Initializes a new instance of the WebControl class using the specified HTML tag.
protected:
WebControl(System::String ^ tag);
protected WebControl (string tag);
new System.Web.UI.WebControls.WebControl : string -> System.Web.UI.WebControls.WebControl
Protected Sub New (tag As String)
Parameters
- tag
- String
An HTML tag.
Remarks
Use this constructor to create and initialize a new instance of the WebControl class using the specified HTML tag.
The following table shows initial property values for an instance of WebControl.
Property | Initial Value |
---|---|
TagKey |
The Unknown enumeration value. |
TagName |
The value of the tag parameter. |
Note
This constructor is not called directly. Instead, it is often called by the constructor of a derived class to initialize the TagKey and TagName properties.
See also
Applies to
WebControl(HtmlTextWriterTag)
Initializes a new instance of the WebControl class using the specified HTML tag.
public:
WebControl(System::Web::UI::HtmlTextWriterTag tag);
public WebControl (System.Web.UI.HtmlTextWriterTag tag);
new System.Web.UI.WebControls.WebControl : System.Web.UI.HtmlTextWriterTag -> System.Web.UI.WebControls.WebControl
Public Sub New (tag As HtmlTextWriterTag)
Parameters
One of the HtmlTextWriterTag values.
Examples
The following example demonstrates how to use the constructor for the WebControl class to create a TextArea
HTML element and display it on the Web Forms page.
Note
The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx file name extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.
Important
This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button1_Click(Object sender, EventArgs e)
{
WebControl wc = new WebControl(HtmlTextWriterTag.Textarea);
PlaceHolder1.Controls.Add(wc);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>WebControl Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>WebControl Constructor Example</h3>
<p>
<asp:PlaceHolder id="PlaceHolder1"
runat="Server"/>
</p>
<p>
<asp:Button id="Button1" runat="Server"
Text="Click to create a new TextArea"
OnClick="Button1_Click" />
</p>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Dim wc As New WebControl(HtmlTextWriterTag.Textarea)
PlaceHolder1.Controls.Add(wc)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>WebControl Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>WebControl Constructor Example</h3>
<p>
<asp:PlaceHolder id="PlaceHolder1"
runat="Server"/>
</p>
<p>
<asp:Button id="Button1" runat="Server"
Text="Click to create a new TextArea"
OnClick="Button1_Click" />
</p>
</div>
</form>
</body>
</html>
Remarks
Use this constructor to create and initialize a new instance of the WebControl class using the specified System.Web.UI.HtmlTextWriterTag value.
The following table shows the initial property value for an instance of WebControl.
Property | Initial Value |
---|---|
TagKey |
The HtmlTextWriterTag enumeration value specified by the tag parameter. |