Freigeben über


Button.Text-Eigenschaft

Ruft den im Button-Steuerelement angezeigten Beschriftungstext ab, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<BindableAttribute(True)> _
<LocalizableAttribute(True)> _
Public Property Text As String
'Usage
Dim instance As Button
Dim value As String

value = instance.Text

instance.Text = value
[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public string Text { get; set; }
[BindableAttribute(true)] 
[LocalizableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get () sealed;
    void set (String^ value) sealed;
}
/** @property */
public final String get_Text ()

/** @property */
public final void set_Text (String value)
public final function get Text () : String

public final function set Text (value : String)

Eigenschaftenwert

Der im Button-Steuerelement angezeigte Beschriftungstext. Der Standardwert ist String.Empty.

Hinweise

Mithilfe der Text-Eigenschaft können Sie die im Button-Steuerelement anzuzeigende Beschriftung angeben oder ermitteln.

Der Wert dieser Eigenschaft (sofern festgelegt) kann mit einem Designertool automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und unter ASP.NET-Globalisierung und -Lokalisierung.

Thema Position
Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite mit Codetrennung in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite mit Codetrennung in Visual Web Developer Erstellen von Anwendungen mit Visual Web Developer

Beispiel

Das folgende Codebeispiel veranschaulicht, wie mit der Text-Eigenschaft die im Button-Steuerelement angezeigte Beschriftung angegeben wird.

<%@ 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 GreetingBtn_Click(ByVal sender As Object, _
                          ByVal e As EventArgs)
   
        ' When the button is clicked,
        ' change the button text, and disable it.
        
        Dim clickedButton As Button = sender
        clickedButton.Text = "...button clicked..."
        clickedButton.Enabled = False
 
        ' Display the greeting label text.
        GreetingLabel.Visible = True
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Button Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <h3>Simple Button Example</h3>
     
      <asp:Button id="Button1"
           Text="Click here for greeting..."
           OnClick="GreetingBtn_Click" 
           runat="server"/>
      <br />
      <br />
      <asp:Label ID="GreetingLabel" runat="server" 
                 Visible=false Text="Hello World!" />
    </div>
    </form>
</body>
</html>
<%@ 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 Page_Load(Object sender, EventArgs e)
    {
        // Manually register the event-handling method for
        // the Click event of the Button control.
        Button1.Click += new EventHandler(this.GreetingBtn_Click);
    }

    void GreetingBtn_Click(Object sender,
                           EventArgs e)
    {
        // When the button is clicked,
        // change the button text, and disable it.

        Button clickedButton = (Button)sender;
        clickedButton.Text = "...button clicked...";
        clickedButton.Enabled = false;
        
        // Display the greeting label text.
        GreetingLabel.Visible = true;
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <h3>Simple Button Example</h3>
     
      <asp:Button id="Button1"
           Text="Click here for greeting..."
           OnClick="GreetingBtn_Click" 
           runat="server"/>
      <br />
      <br />
      <asp:Label ID="GreetingLabel" runat="server" 
                 Visible=false Text="Hello World!" />
    </div>
    </form>
</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Button-Klasse
Button-Member
System.Web.UI.WebControls-Namespace
String.Empty

Weitere Ressourcen

Button-Webserver-Steuerelemente