WebControl Konstruktoren

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Initialisiert eine neue Instanz der WebControl-Klasse.

Überlädt

WebControl()

Initialisiert eine neue Instanz der WebControl-Klasse, die ein Span-HTML-Tag darstellt.
WebControl(String)

Initialisiert eine neue Instanz der WebControl-Klasse unter Verwendung des angegebenen HTML-Tags.
WebControl(HtmlTextWriterTag)

Initialisiert eine neue Instanz der WebControl-Klasse unter Verwendung des angegebenen HTML-Tags.

WebControl()

Initialisiert eine neue Instanz der WebControl-Klasse, die ein Span-HTML-Tag darstellt.

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

Hinweise

Dieser Konstruktor wird verwendet, um eine neue Instanz der -Klasse zu initialisieren, die WebControl ein Span HTML-Element darstellt.

Die folgende Tabelle zeigt den anfänglichen Eigenschaftswert für eine Instanz von WebControl.

Eigenschaft Anfangswert
TagKey Der Span-Enumerationswert.

Hinweis

Dieser Konstruktor wird nicht direkt aufgerufen. Stattdessen wird sie häufig vom Konstruktor einer abgeleiteten Klasse aufgerufen, um die TagKey Eigenschaft für den Span Enumerationswert zu initialisieren.

Weitere Informationen

Gilt für:

WebControl(String)

Initialisiert eine neue Instanz der WebControl-Klasse unter Verwendung des angegebenen HTML-Tags.

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)

Parameter

tag
String

Ein HTML-Tag.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der -Klasse mit dem WebControl angegebenen HTML-Tag zu erstellen und zu initialisieren.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz von aufgeführt WebControl.

Eigenschaft Anfangswert
TagKey Der Unknown-Enumerationswert.
TagName Der Wert des tag-Parameters.

Hinweis

Dieser Konstruktor wird nicht direkt aufgerufen. Stattdessen wird sie häufig vom Konstruktor einer abgeleiteten Klasse aufgerufen, um die TagKey Eigenschaften und TagName zu initialisieren.

Weitere Informationen

Gilt für:

WebControl(HtmlTextWriterTag)

Initialisiert eine neue Instanz der WebControl-Klasse unter Verwendung des angegebenen HTML-Tags.

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)

Parameter

tag
HtmlTextWriterTag

Einer der HtmlTextWriterTag-Werte.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie den Konstruktor für die WebControl Klasse verwenden, um ein TextArea HTML-Element zu erstellen und es auf der Web Forms-Seite anzuzeigen.

Hinweis

Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer .aspx Dateinamenerweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms-Seitencodemodell.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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>

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der -Klasse mit dem WebControl angegebenen System.Web.UI.HtmlTextWriterTag Wert zu erstellen und zu initialisieren.

Die folgende Tabelle zeigt den anfänglichen Eigenschaftswert für eine Instanz von WebControl.

Eigenschaft Anfangswert
TagKey Der HtmlTextWriterTag durch den tag -Parameter angegebene Enumerationswert.

Weitere Informationen

Gilt für: