WebControl 建構函式

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

初始化 WebControl 類別的新執行個體。

多載

WebControl()

初始化 WebControl 類別的新執行個體，這個執行個體表示 Span HTML 標記。
WebControl(String)

使用指定的 HTML 標記，初始化 WebControl 類別的新執行個體。
WebControl(HtmlTextWriterTag)

使用指定的 HTML 標記，初始化 WebControl 類別的新執行個體。

WebControl()

初始化 WebControl 類別的新執行個體，這個執行個體表示 Span HTML 標記。

protected:
 WebControl();
protected WebControl ();
Protected Sub New ()

備註

這個建構函式是用來初始化 類別的新實例，這個實例 WebControl 表示 Span HTML 專案。

下表顯示 實例 WebControl 的初始屬性值。

屬性 初始值
TagKey Span 列舉值。

注意

此建構函式不會直接呼叫。 相反地，衍生類別的建構函式通常會呼叫它，以將 屬性初始化 TagKey 為 Span 列舉值。

另請參閱

適用於

WebControl(String)

使用指定的 HTML 標記，初始化 WebControl 類別的新執行個體。

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)

參數

tag
String

HTML 標記。

備註

使用此建構函式，使用指定的 HTML 標籤來建立和初始化 類別的新實例 WebControl 。

下表顯示 實例 WebControl 的初始屬性值。

屬性 初始值
TagKey Unknown 列舉值。
TagName tag 參數的值。

注意

此建構函式不會直接呼叫。 相反地，衍生類別的建構函式通常會呼叫它來初始化 TagKey 和 TagName 屬性。

另請參閱

適用於

WebControl(HtmlTextWriterTag)

使用指定的 HTML 標記，初始化 WebControl 類別的新執行個體。

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)

參數

tag
HtmlTextWriterTag

其中一個 HtmlTextWriterTag 值。

範例

下列範例示範如何使用 類別的 WebControl 建構函式來建立 TextArea HTML 元素，並在Web Form頁面上顯示它。

注意

下列程式碼範例會使用單一檔案程式碼模型，如果直接複製到程式碼後置檔案，可能無法正常運作。 此程式碼範例必須複製到副檔名為 .aspx 的空白文字檔。 如需Web Form程式碼模型的詳細資訊，請參閱ASP.NET Web Forms頁碼模型。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 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>

備註

使用此建構函式，使用指定的 System.Web.UI.HtmlTextWriterTag 值來建立和初始化 類別的新實例 WebControl 。

下表顯示 實例 WebControl 的初始屬性值。

屬性 初始值
TagKey 參數 HtmlTextWriterTag 所 tag 指定的列舉值。

另請參閱

適用於