Button Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Zeigt ein Schaltflächen-Steuerelement auf der Webseite an.
public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler
public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControl
public class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler
public class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControl
type Button = class
inherit WebControl
interface IPostBackEventHandler
type Button = class
inherit WebControl
interface IButtonControl
interface IPostBackEventHandler
Public Class Button
Inherits WebControl
Implements IPostBackEventHandler
Public Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler
- Vererbung
- Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein Submit-Steuerelement Button erstellt wird, das den Webseiteninhalt zurück an den Server sendet.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Button Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text="Hello World!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Button Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "Hello World!!"
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
Im folgenden Codebeispiel wird das Erstellen eines Befehlssteuerelements Button veranschaulicht, das eine Liste sortiert.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button CommandName Example</title>
<script runat="server">
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
switch(e.CommandName)
{
case "Sort":
// Call the method to sort the list.
Sort_List((String)e.CommandArgument);
break;
case "Submit":
// Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button";
// Test whether the command argument is an empty string ("").
if((String)e.CommandArgument == "")
{
// End the message.
Message.Text += ".";
}
else
{
// Display an error message for the command argument.
Message.Text += ", however the command argument is not recogized.";
}
break;
default:
// The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized.";
break;
}
}
void Sort_List(string commandArgument)
{
switch(commandArgument)
{
case "Ascending":
// Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button.";
break;
case "Descending":
// Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button.";
break;
default:
// The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized.";
break;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button CommandName Example</title>
<script runat="server">
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Select e.CommandName
Case "Sort"
' Call the method to sort the list.
Sort_List(CType(e.CommandArgument, String))
Case "Submit"
' Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button"
' Test whether the command argument is an empty string ("").
If CType(e.CommandArgument , String) = "" Then
' End the message.
Message.Text &= "."
Else
' Display an error message for the command argument.
Message.Text &= ", however the command argument is not recogized."
End If
Case Else
' The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized."
End Select
End Sub
Sub Sort_List(commandArgument As String)
Select commandArgument
Case "Ascending"
' Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button."
Case "Descending"
' Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button."
Case Else
' The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized."
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
Hinweise
In diesem Thema:
Einführung
Verwenden Sie das Button Steuerelement, um eine Pushschaltfläche auf der Webseite zu erstellen, mit der Benutzer eine Seite auf dem Server posten können. Das Steuerelement löst ein Ereignis im Servercode aus, das Sie behandeln können, um auf den Postback zu reagieren. Es kann auch ein Ereignis im Clientskript auslösen, das Sie behandeln können, bevor die Seite gepostet wird oder die ausführung und dann die Übermittlung der Seite abbrechen kann.
Hinweis
ASP.NET enthält verschiedene Arten von Schaltflächensteuerelementen, die jeweils auf Webseiten unterschiedlich angezeigt werden. Sie sind das Button Steuerelement, das als Knopfdruck gerendert wird; das LinkButton Steuerelement, das als Link gerendert wird, und das ImageButton Steuerelement, das als Bild gerendert wird; und das ImageMap Steuerelement, mit dem Sie eine Grafik erstellen können, auf die Die Benutzer klicken können. Standardmäßig übermitteln alle Schaltflächensteuerelemente die Seite, wenn sie geklickt wird. Sie können auch die HtmlButton Steuerelemente HtmlInputButton verwenden, um Schaltflächen auf der Seite zu erstellen, die im Servercode programmierbar sind. Ausführliche Informationen zu den Unterschieden zwischen HTML- und Webserversteuerelementen finden Sie unter ASP.NET Web Server Controls Overview.
Standardmäßig ist ein Button Steuerelement eine Schaltfläche "Absenden". Eine Schaltfläche "Absenden" hat keinen Befehlsnamen (angegeben durch die Eigenschaft), der CommandName der Schaltfläche zugeordnet ist, und sendet einfach die Webseite zurück an den Server. Sie können einen Ereignishandler für das Click Ereignis bereitstellen, um die Ausgeführten Aktionen programmgesteuert zu steuern, wenn auf die Schaltfläche "Absenden" geklickt wird.
Eine Befehlsschaltfläche weist einen Befehlsnamen auf, der der Schaltfläche zugeordnet ist, z Sort. B. durch Festlegen der CommandName Eigenschaft. Auf diese Weise können Sie mehrere Button Steuerelemente auf einer Webseite erstellen und programmgesteuert bestimmen, auf welches Button Steuerelement geklickt wird. Sie können die CommandArgument Eigenschaft auch mit einer Befehlsschaltfläche verwenden, um zusätzliche Informationen zum auszuführenden Befehl bereitzustellen, z Ascending. B. . Sie können einen Ereignishandler für das Command Ereignis bereitstellen, um die ausgeführten Aktionen programmgesteuert zu steuern, wenn auf die Befehlsschaltfläche geklickt wird.
Schaltflächenpostbackverhalten und Serverereignisse
Wenn ein Benutzer auf eine beliebige Webserver-Steuerelementschaltfläche klickt, wird die Seite an den Server gesendet. Dies bewirkt, dass die Webseite verarbeitet wird und alle ausstehenden Ereignisse im serverbasierten Code ausgelöst werden. Wenn alle Seiten- und Steuerelementverarbeitung abgeschlossen ist, wird die Seite wieder im Browser gerendert.
Die Schaltflächen können eigene Click Ereignisse oder Command Ereignisse auslösen, die Sie mithilfe von serverbasiertem Code behandeln können. Dies unterscheidet sich von Ereignissen auf herkömmlichen HTML-Seiten oder clientbasierten Webanwendungen, bei denen das Ereignis einer Schaltfläche onclick mithilfe von JavaScript behandelt wird, das im Client ausgeführt wird. Weitere Informationen finden Sie unter ASP.NET Web Forms Server Control Event Model.
Wenn Benutzer auf ein Schaltflächensteuerelement klicken, wird die Seite wieder auf den Server gepostet. Standardmäßig wird die Seite wieder auf sich selbst gepostet,
Sie können Schaltflächen konfigurieren, um die aktuelle Seite auf einer anderen Seite zu veröffentlichen. Dies kann beim Erstellen von mehrseitigen Formularen hilfreich sein. Ausführliche Informationen finden Sie unter "Seitenübergreifendes Posten" in ASP.NET Webformularen.
Behandeln von Schaltflächenereignissen in Clientskript
Schaltflächensteuerelemente können sowohl Serverereignisse als auch Clientereignisse auslösen. Serverereignisse treten nach dem Postback auf und werden im serverseitigen Code behandelt, den Sie für die Seite schreiben. Clientereignisse werden im Clientskript behandelt, in der Regel ECMAScript (JavaScript) und werden ausgelöst, bevor die Seite übermittelt wird. Indem Sie clientseitige Ereignisse zu ASP.NET Schaltflächensteuerelementen hinzufügen, können Sie Aufgaben wie das Anzeigen von Bestätigungsdialogfeldern vor dem Übermitteln der Seite ausführen und die Übermittlung möglicherweise abbrechen. Ausführliche Informationen finden Sie unter Clientskript in ASP.NET Webseiten und Vorgehensweise: Reagieren auf Schaltflächen-Webserver-Steuerelementereignisse in Clientskript.
Möglicherweise möchten Sie auch, dass das Button Steuerelement auch das Clientskript zum Ausführen des Postbacks verwendet (anstatt einfach einen HTTP POST-Vorgang auszuführen). Dies kann hilfreich sein, wenn Sie das Postback programmgesteuert bearbeiten möchten, z. B. das Anfügen an andere Elemente auf der Seite. Sie können die Eigenschaft des Button Steuerelements UseSubmitBehavior so festlegen, dass das Button Steuerelement clientskriptbasiertes Postback true verwendet.
Schaltflächensteuerelemente und Überprüfung
Wenn eine Seite ASP.NET Validator-Steuerelemente enthält, bewirkt das Klicken auf ein Schaltflächensteuerelement, dass das Validator-Steuerelement seine Überprüfung durchführt. Wenn die clientseitige Überprüfung für ein Validator-Steuerelement aktiviert ist, wird die Seite nicht übermittelt, wenn eine Überprüfung fehlgeschlagen ist.
In der folgenden Tabelle werden die Eigenschaften beschrieben, die von Schaltflächensteuerelementen unterstützt werden, mit denen Sie den Überprüfungsprozess genauer steuern können.
| Eigentum | Beschreibung |
|---|---|
| CausesValidation | Gibt an, ob durch Klicken auf die Schaltfläche auch eine Überprüfung durchgeführt wird. Legen Sie diese Eigenschaft fest, um eine Überprüfung zu false verhindern. |
| ValidationGroup | Hiermit können Sie angeben, welche Validatoren auf der Seite aufgerufen werden, wenn auf die Schaltfläche geklickt wird. Wenn keine Überprüfungsgruppen eingerichtet sind, ruft eine Schaltfläche alle Validatoren auf, die sich auf der Seite befinden. |
Weitere Informationen finden Sie unter Überprüfen der Benutzereingabe in ASP.NET Webseiten.
Schaltflächen in Datensteuerelementen
Schaltflächen-Webserversteuerelemente werden häufig in Datensteuerelementen verwendet, z. B. in den DataListSteuerelementen , GridViewund Repeater Listensteuerelementen. In diesen Fällen reagieren Sie in der Regel nicht direkt auf das Schaltflächenklickereignis. Stattdessen löst eine Schaltfläche in einem Datensteuerelement ein Ereignis aus, das für das Datensteuerelement spezifisch ist. Beispielsweise kann eine Schaltfläche im DataList Steuerelement das Ereignis des DataList Steuerelements ItemCommand auslösen, anstatt das Ereignis des Button Steuerelements Click zu auslösen.
Da datengebundene Listensteuerelemente viele Schaltflächen enthalten können, können Sie die Eigenschaft der Schaltfläche festlegen, um einen Wert anzugeben, der als Teil des Ereignisses CommandArgument übergeben werden soll. Anschließend können Sie dieses Argument testen, um zu sehen, auf welche Schaltfläche geklickt wurde.
Binden von Daten an die Steuerelemente
Sie können die Schaltflächenwebserversteuerelemente an eine Datenquelle binden, um ihre Eigenschafteneinstellungen dynamisch zu steuern. Sie können beispielsweise die Eigenschaft einer Schaltfläche Text mithilfe der Datenbindung festlegen.
Verwenden von Schaltflächen mit UpdatePanel-Steuerelementen
Das Teilweise Seitenrendering ermöglicht es, Teile einer Seite ohne Postback zu aktualisieren. UpdatePanel Mithilfe von Steuerelementen können Sie Teile der Seite markieren, die an partiellem Seitenrendering teilnehmen. Standardmäßig besteht das Verhalten von Steuerelementen innerhalb eines UpdatePanel Steuerelements, einschließlich Button Steuerelementen, darin, einen asynchronen Postback anstelle eines Postbacks auszuführen. Dadurch wird nur der Inhalt des UpdatePanel Steuerelements aktualisiert, aus dem der Postback stammt.
Zusätzlich zum Szenario eines Steuerelements, das sich innerhalb eines ButtonUpdatePanel Steuerelements befindet, können Sie Steuerelemente in den folgenden Szenarien mit UpdatePanel Steuerelementen verwendenButton:
Definieren eines Button Steuerelements außerhalb eines UpdatePanel Steuerelements als AsyncPostBackTrigger Steuerelement für dieses Panel. Wenn auf die Schaltfläche geklickt wird, führt sie einen asynchronen Postback aus und aktualisiert den Inhalt des Panels.
Definieren eines Steuerelements, das sich innerhalb eines ButtonUpdatePanel Steuerelements als PostBackTrigger Steuerelement für das Panel befindet. Wenn auf die Schaltfläche geklickt wird, führt sie einen Postback aus, obwohl sie sich innerhalb eines UpdatePanel Steuerelements befindet.
Weitere Informationen zum teilweisen Rendern von Seiten und zur Verwendung von UpdatePanel Steuerelementen finden Sie unter UpdatePanel Control Overview und Partial-Page Rendering Overview.
Deklarative Syntax
<asp:Button
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
UseSubmitBehavior="True|False"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Konstruktoren
| Name | Beschreibung |
|---|---|
| Button() |
Initialisiert eine neue Instanz der Button-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control) |
| Attributes |
Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| BackColor |
Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von WebControl) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| BorderColor |
Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderStyle |
Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von WebControl) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| CausesValidation |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Überprüfung ausgeführt wird, wenn auf das Button Steuerelement geklickt wird. |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| CommandArgument |
Dient zum Abrufen oder Festlegen eines optionalen Parameters, der zusammen mit dem zugeordneten CommandNameEreignis an das Command Ereignis übergeben wird. |
| CommandName |
Dient zum Abrufen oder Festlegen des Befehlsnamens, der dem Button Steuerelement zugeordnet ist, das an das Command Ereignis übergeben wird. |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control) |
| ControlStyle |
Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ControlStyleCreated |
Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird. (Geerbt von WebControl) |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Enabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Webserversteuerelement aktiviert ist. (Geerbt von WebControl) |
| EnableTheming |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von WebControl) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| ForeColor |
Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat. (Geerbt von WebControl) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsEnabled |
Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control) |
| OnClientClick |
Dient zum Abrufen oder Festlegen des clientseitigen Skripts, das ausgeführt wird, wenn das Ereignis eines Button Steuerelements Click ausgelöst wird. |
| Page |
Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| PostBackUrl |
Ruft die URL der Seite ab, auf die die aktuelle Seite gesendet werden soll, wenn auf das Steuerelement geklickt wird, oder legt diese Button fest. |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von WebControl) |
| Style |
Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob das Steuerelement das |
| TabIndex |
Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements. (Geerbt von WebControl) |
| TagKey |
Ruft den Wert ab, der HtmlTextWriterTag diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TagName |
Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TemplateControl |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| Text |
Ruft die im Button Steuerelement angezeigte Textbeschriftung ab oder legt sie fest. |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| UseSubmitBehavior |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Button Steuerelement den Sendemechanismus des Clientbrowsers oder den ASP.NET Postbackmechanismus verwendet. |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| ValidationGroup |
Dient zum Abrufen oder Festlegen der Gruppe von Steuerelementen, für die das Button Steuerelement eine Überprüfung verursacht, wenn es wieder auf dem Server veröffentlicht wird. |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control) |
| Width |
Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von WebControl) |
Methoden
| Name | Beschreibung |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Fügt dem Ausgabedatenstrom die Attribute des Button Steuerelements zum Rendern auf dem Client hinzu. |
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control) |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ApplyStyleSheetSkin(Page) |
Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| CopyBaseAttributes(WebControl) |
Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control) |
| CreateControlStyle() |
Erstellt das Formatvorlagenobjekt, das intern von der WebControl Klasse verwendet wird, um alle formatbezogenen Eigenschaften zu implementieren. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetDesignModeState() |
Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetPostBackOptions() |
Erstellt ein PostBackOptions Objekt, das das Postbackverhalten des Button Steuerelements darstellt. |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt Ansichtsstatusinformationen aus einer vorherigen Anforderung wieder her, die mit der SaveViewState() Methode gespeichert wurde. (Geerbt von WebControl) |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MergeStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control) |
| OnClick(EventArgs) | |
| OnCommand(CommandEventArgs) | |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von Control) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Bestimmt, ob auf die Schaltfläche vor dem Rendern auf dem Client geklickt wurde. |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von Control) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control) |
| RaisePostBackEvent(String) |
Löst Ereignisse für das Button Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird. |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert das Steuerelement an den angegebenen HTML-Writer. (Geerbt von WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderContents(HtmlTextWriter) |
Rendert den Inhalt des Steuerelements an den angegebenen Writer. |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von WebControl) |
| SetDesignModeState(IDictionary) |
Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können. (Geerbt von WebControl) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Click |
Tritt auf, wenn auf das Button Steuerelement geklickt wird. |
| Command |
Tritt auf, wenn auf das Button Steuerelement geklickt wird. |
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest. (Geerbt von WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Löst Ereignisse für das Button Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück. |