Button Klasse

Definition

Zeigt ein Schaltflächen-Steuerelement auf der Webseite an.Displays a push button control on the Web page.

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, System.Web.UI.WebControls.IButtonControl
type Button = class
    inherit WebControl
    interface IButtonControl
    interface IPostBackEventHandler
Public Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler
Vererbung
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Submit Button -Steuerelement erstellt wird, das den Webseiteninhalt an den Server zurücksendet.The following code example demonstrates how to create a Submit Button control that posts the Web page content back to the server.

<%@ 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 veranschaulicht, wie ein Befehls Button Steuerelement erstellt wird, das eine Liste sortiert.The following code example demonstrates how to create a Command Button control that sorts a list.

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

      &nbsp;

      <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"/>

      &nbsp;

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <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"/>

      &nbsp;

      <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"/>

      &nbsp;

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <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:In this topic:

EinführungIntroduction

Verwenden Sie Button das-Steuerelement, um auf der Webseite eine pushschaltfläche zu erstellen, mit der Benutzer eine Seite auf dem Server veröffentlichen können.Use the Button control to create a push button on the Web page that lets users to post a page to the server. Das-Steuerelement löst ein Ereignis im Servercode aus, das Sie behandeln können, um auf das Postback zu reagieren.The control triggers an event in server code that you can handle to respond to the postback. Außerdem kann ein Ereignis in einem Client Skript angezeigt werden, das Sie behandeln können, bevor die Seite gepostet wird oder ausgeführt werden kann, und die Übermittlung der Seite abbrechen.It can also raise an event in client script that you can handle before the page is posted or that can run and then cancel submission of the page.

Hinweis

ASP.NET enthält verschiedene Arten von Schaltflächen-Steuerelementen, die jeweils auf Webseiten unterschiedlich angezeigt werden.ASP.NET includes several kinds of button controls, each of which appears differently on Web pages. Dabei handelt es Button sich um das Steuerelement, das als pushschaltfläche gerendert wird, das LinkButton -Steuer ImageButton Element, das als Link gerendert wird, ImageMap und das-Steuerelement, das als Bild gerendert wird. , auf den Benutzer klicken können.They are the Button control, which renders as a push button; the LinkButton control, which renders as a link; and the ImageButton control, which renders as an image; and the ImageMap control, which lets you create a graphic that has hotspots that users can click. Standardmäßig senden alle Schaltflächen-Steuerelemente die Seite, wenn darauf geklickt wird.By default, all button controls submit the page when clicked. Sie können auch die HtmlButton Steuerelemente und HtmlInputButton verwenden, um Schaltflächen auf der Seite zu erstellen, die im Servercode programmierbar sind.You can also use the HtmlButton and HtmlInputButton controls to create buttons on the page that are programmable in server code. Ausführliche Informationen zu den Unterschieden zwischen HTML-und Webserver-Steuerelementen finden Sie unter ASP.NET Webserver Controls Overview.For details about the differences between HTML and Web server controls, see ASP.NET Web Server Controls Overview.

Standardmäßig ist ein Button -Steuerelement eine Schaltfläche zum Senden.By default, a Button control is a Submit button. Eine Schaltfläche "Senden" weist keinen Befehlsnamen (durch die CommandName -Eigenschaft angegeben) auf, der der Schaltfläche zugeordnet ist, und sendet die Webseite einfach zurück an den Server.A Submit button does not have a command name (specified by the CommandName property) associated with the button and simply posts the Web page back to the server. Sie können einen Ereignishandler für das Click -Ereignis bereitstellen, um die Aktionen Programm gesteuert zu steuern, die beim Klicken auf die Schaltfläche Senden ausgeführt werden.You can provide an event handler for the Click event to programmatically control the actions performed when the Submit button is clicked.

Eine Befehls Schaltfläche verfügt über einen Befehlsnamen, der der Schalt SortFläche zugeordnet ist, CommandName z. b. durch Festlegen der-Eigenschaft.A Command button has a command name associated with the button, such as Sort, by setting the CommandName property. Dies ermöglicht es Ihnen, mehrere Button Steuerelemente auf einer Webseite zu erstellen und Programm gesteuert Button zu ermitteln, auf welches Steuerelement geklickt wird.This allows you to create multiple Button controls on a Web page and programmatically determine which Button control is clicked. Sie können auch die CommandArgument -Eigenschaft mit einer Befehls Schaltfläche verwenden, um zusätzliche Informationen zum auszuführenden Befehl bereitzustellen, Ascendingz. b.You can also use the CommandArgument property with a command button to provide additional information about the command to perform, such as Ascending. Sie können einen Ereignishandler für das Command -Ereignis bereitstellen, um die Aktionen Programm gesteuert zu steuern, die beim Klicken auf die Befehls Schaltfläche ausgeführt werden.You can provide an event handler for the Command event to programmatically control the actions performed when the Command button is clicked.

Schaltfläche-Postback Verhalten und Server EreignisseButton Postback Behavior and Server Events

Wenn ein Benutzer auf eine beliebige Webserver-Steuerelement Schaltfläche klickt, wird die Seite an den Server gesendet.When a user clicks any Web server control button, the page is sent to the server. Dies bewirkt, dass die Webseite verarbeitet wird und alle ausstehenden Ereignisse in Server basiertem Code ausgelöst werden.This causes the Web page to be processed and any pending events to be raised in server-based code. Wenn die gesamte Seiten-und Steuerelement Verarbeitung abgeschlossen ist, wird die Seite wieder in den Browser gerendert.When all page and control processing has finished, the page renders itself to the browser again.

Die Schaltflächen können Ihre eigenen Click Ereignisse oder Command Ereignisse, die Sie mithilfe von Server basiertem Code verarbeiten können, lösen.The buttons can raise their own Click events or Command event, which you can handle by using server-based code. Dies unterscheidet sich von Ereignissen in herkömmlichen HTML-Seiten oder in Client basierten Webanwendungen, bei denen onclick das-Ereignis einer Schaltfläche mithilfe von JavaScript behandelt wird, das auf dem Client ausgeführt wird.This is different than events in traditional HTML pages or in client-based Web applications, where a button's onclick event is handled by using JavaScript that runs in the client. Weitere Informationen finden Sie unter ASP.net Web Forms-Serversteuerelement Event Model.For more information, see ASP.NET Web Forms Server Control Event Model.

Wenn Benutzer auf ein Schaltflächen-Steuerelement klicken, wird die Seite an den Server zurückgesendet.When users click a button control, the page is posted back to the server. Standardmäßig wird die Seite an sich selbst zurückgesendet,By default, the page is posted back to itself,

Sie können Schaltflächen konfigurieren, um die aktuelle Seite auf einer anderen Seite zu veröffentlichen.You can configure buttons to post the current page to another page. Dies kann beim Erstellen von mehrseitigen Formularen nützlich sein.This can be useful for creating multi-page forms. Weitere Informationen finden Sie unter Cross-Page Posting in ASP.net Web Forms.For details, see Cross-Page Posting in ASP.NET Web Forms.

Behandeln von Schaltflächen Ereignissen in Client SkriptsHandling Button Events in Client Script

Schaltflächen-Steuerelemente können sowohl Server Ereignisse als auch Client Ereignisse hervorrufen.Button controls can raise both server events and client events. Server Ereignisse treten nach dem Postback auf, und Sie werden im serverseitigen Code behandelt, den Sie für die Seite schreiben.Server events occur after postback, and they are handled in the server-side code that you write for the page. Client Ereignisse werden in Client Skripts behandelt, in der Regel ECMAScript (JavaScript), und werden ausgelöst, bevor die Seite übermittelt wird.Client events are handled in client script, typically ECMAScript (JavaScript), and are raised before the page is submitted. Durch das Hinzufügen von Client seitigen Ereignissen zu ASP.net-Schaltflächen-Steuerelementen können Sie Aufgaben wie das Anzeigen von Bestätigungs Dialogfeldern vor dem Senden der Seite ausführen und die Übermittlung möglicherweise abbrechen.By adding client-side events to ASP.NET button controls, you can perform tasks such as displaying confirmation dialog boxes before submitting the page, and potentially cancel the submission. Weitere Informationen finden Sie unter Client Script in ASP.net Web Pages und Gewusst wie: Reagieren Sie auf Schaltflächen-Webserver Steuerelement-Ereignisse in Client Skripts.For details, see Client Script in ASP.NET Web Pages and How to: Respond to Button Web Server Control Events in Client Script.

Sie können auch festlegen, Button dass das-Steuerelement auch das-Client Skript zum Durchführen des Postbacks verwenden soll (anstatt einfach einen HTTP Post-Vorgang auszuführen).You might also want the Button control to also use client script to perform the postback (instead of simply performing an HTTP POST operation). Dies kann hilfreich sein, wenn Sie das Postback Programm gesteuert bearbeiten möchten, z. b. das Anfügen an andere Elemente auf der Seite.This can be useful if you want to programmatically manipulate the postback, such as attaching it to other elements on the page. Sie können die- Button Eigenschaft des UseSubmitBehavior -Steuer true Elements auf festlegen Button , um zu bewirken, dass das-Steuerelement ein Client Skript basiertes Postback verwendet.You can set the Button control's UseSubmitBehavior property to true to cause the Button control to use client-script based postback.

Schaltflächen-Steuerelemente und ValidierungButton Controls and Validation

Wenn eine Seite ASP.net Prüfungs-Steuerelemente enthält, führt das Klicken auf ein Schaltflächen-Steuerelement standardmäßig dazu, dass das Validierungs Steuerelement die Überprüfung ausführt.If a page contains ASP.NET validator controls, by default, clicking a button control causes the validator control to perform its check. Wenn die Client seitige Validierung für ein Prüfungs-Steuerelement aktiviert ist, wird die Seite nicht gesendet, wenn bei der Überprüfung ein Fehler aufgetreten ist.If client-side validation is enabled for a validator control, the page is not submitted if a validation check has failed.

In der folgenden Tabelle werden die von Schaltflächen-Steuerelementen unterstützten Eigenschaften beschrieben, mit denen Sie den Überprüfungsprozess genauer steuern können.The following table describes the properties supported by button controls that enable you to control the validation process more precisely.

EigenschaftProperty BeschreibungDescription
CausesValidation Gibt an, ob beim Klicken auf die Schaltfläche auch eine Validierungs Überprüfung durchführtSpecifies whether clicking the button also performs a validation check. Legen Sie diese Eigenschaft false auf fest, um eine Validierungs Überprüfung zu verhindern.Set this property to false to prevent a validation check.
ValidationGroup Ermöglicht Ihnen, anzugeben, welche Validierungs Steuerelemente auf der Seite aufgerufen werden, wenn auf die Schaltfläche geklickt wird.Enables you to specify which validators on the page are called when the button is clicked. Wenn keine Validierungs Gruppen erstellt werden, werden durch Klicken auf die Schaltfläche alle Validierungs Steuerelemente auf der Seite aufgerufen.If no validation groups are established, a button click calls all of the validators that are on the page.

Weitere Informationen finden Sie unter Überprüfen der Benutzereingabe in ASP.NET-Webseiten.For more information, see Validating User Input in ASP.NET Web Pages.

Schaltflächen in Daten SteuerelementenButtons in Data Controls

Schaltflächen-Webserver Steuerelemente werden häufig in Daten Steuerelementen verwendet, z DataList. GridViewb. Repeater in den Listen Steuerelementen, und.Button Web server controls are often used in data controls, such as in the DataList, GridView, and Repeater list controls. In diesen Fällen reagieren Sie in der Regel nicht direkt auf das Click-Ereignis der Schaltfläche.In those cases, you typically do not respond directly to the button click event. Stattdessen löst eine Schaltfläche in einem Daten Steuerelement ein Ereignis aus, das für das Daten Steuerelement spezifisch ist.Instead, a button in a data control raises an event that is specific to the data control. Beispielsweise kann eine Schalt DataList Fläche im-Steuerelement das- DataList Ereignis des ItemCommand -Steuer Elements erhöhen, Button anstatt das Click -Ereignis des-Steuer Elements zu erhöhen.For example, in the DataList control, a button might raise the DataList control's ItemCommand event instead of raising the Button control's Click event.

Da Daten gebundene Listen Steuerelemente viele Schaltflächen enthalten können, können Sie die- CommandArgument Eigenschaft der Schaltfläche festlegen, um einen Wert anzugeben, der als Teil des Ereignisses übergeben werden soll.Because data-bound list controls can contain many buttons, you can set the button's CommandArgument property to specify a value to pass as part of the event. Sie können dann auf dieses Argument testen, um anzuzeigen, auf welche Schaltfläche geklickt wurde.You can then test for this argument to see which button was clicked.

Binden von Daten an die SteuerelementeBinding Data to the Controls

Sie können die Schaltflächen-Webserver Steuerelemente an eine Datenquelle binden, um Ihre Eigenschafts Einstellungen dynamisch zu steuern.You can bind the button Web server controls to a data source in order to control their property settings dynamically. Beispielsweise können Sie die- Text Eigenschaft einer Schaltfläche mithilfe der Datenbindung festlegen.For example, you can set a button's Text property by using data binding.

Verwenden von Schaltflächen mit Update Panel-SteuerelementenUsing Buttons with UpdatePanel Controls

Das partielle Seiten Rendering ermöglicht das Aktualisieren von Teilen einer Seite ohne Postback.Partial-page rendering makes it possible to refresh portions of a page without a postback. UpdatePanelSteuerelemente ermöglichen es Ihnen, Teile der Seite zu markieren, die am Teil Rendering von Seiten beteiligt sind.UpdatePanel controls enable you to mark parts of the page that participate in partial-page rendering. Standardmäßig ist das Verhalten von Steuerelementen in UpdatePanel einem-Steuer Button Element, einschließlich Steuerelementen, das Ausführen eines asynchronen Postbacks anstelle eines Postbacks.By default, the behavior of controls inside an UpdatePanel control, including Button controls, is to perform an asynchronous postback instead of a postback. Dadurch wird nur der Inhalt des UpdatePanel Steuer Elements aktualisiert, von dem das Postback stammt.This refreshes only the contents of the UpdatePanel control from which the postback originates.

Zusätzlich zum Szenario Button eines Steuer Elements, das sich innerhalb eines UpdatePanel -Steuer Elements befindet, können Sie Steuer UpdatePanel Elemente mit Steuerelementen in den folgenden Szenarien verwenden Button :In addition to the scenario of a Button control that is inside an UpdatePanel control, you can use Button controls with UpdatePanel controls in the following scenarios:

  • Definieren eines Button Steuer Elements, das sich UpdatePanel außerhalb eines Steuer AsyncPostBackTrigger Elements befindet, als Steuerelement für diesen Bereich.Defining a Button control that is outside an UpdatePanel control as an AsyncPostBackTrigger control for that panel. Wenn auf die Schaltfläche geklickt wird, führt Sie ein asynchrones Postback durch und aktualisiert den Inhalt des Bereichs.When the button is clicked, it performs an asynchronous postback and refreshes the contents of the panel.

  • Definieren eines Button Steuer Elements, das sich UpdatePanel innerhalb eines- PostBackTrigger Steuer Elements befindet, als für den Bereich.Defining a Button control that is inside an UpdatePanel control as a PostBackTrigger for the panel. Wenn auf die Schaltfläche geklickt wird, wird ein Postback durchführt, obwohl es UpdatePanel sich in einem-Steuerelement befindet.When the button is clicked, it performs a postback even though it is inside an UpdatePanel control.

Weitere Informationen zum partiellen Seiten Rendering und zum verwenden UpdatePanel von Steuerelementen finden Sie unter Übersicht über das Update Panel-Steuer Element und Übersicht über das Seiten Rendering.For more information about partial-page rendering and using UpdatePanel controls, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

Deklarative SyntaxDeclarative 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

Button()

Initialisiert eine neue Instanz der Button-Klasse.Initializes a new instance of the Button class.

Eigenschaften

AccessKey

Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.Gets the browser-specific adapter for the control.

(Geerbt von Control)
AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Geerbt von Control)
Attributes

Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Geerbt von WebControl)
BackColor

Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest.Gets or sets the background color of the Web server control.

(Geerbt von WebControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.Gets the control that contains this control's data binding.

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.Gets or sets the border color of the Web control.

(Geerbt von WebControl)
BorderStyle

Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest.Gets or sets the border style of the Web server control.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.Gets or sets the border width of the Web server control.

(Geerbt von WebControl)
CausesValidation

Ruft einen Wert ab, der angibt, ob beim Klicken auf das Button-Steuerelement eine Validierung durchgeführt wird, oder legt diesen fest.Gets or sets a value indicating whether validation is performed when the Button control is clicked.

ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.Gets a value that indicates whether the server control's child controls have been created.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.Gets the control ID for HTML markup that is generated by ASP.NET.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.Gets a character value representing the separator character used in the ClientID property.

(Geerbt von Control)
CommandArgument

Ruft einen zusammen mit dem zugeordneten Command an das CommandName-Ereignis übergebenen optionalen Parameter ab, oder legt diesen fest.Gets or sets an optional parameter passed to the Command event along with the associated CommandName.

CommandName

Ruft den dem Button-Steuerelement zugeordneten Befehlsnamen ab, der an das Command-Ereignis übergeben wird, oder legt diesen fest.Gets or sets the command name associated with the Button control that is passed to the Command event.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.Gets the HttpContext object associated with the server control for the current Web request.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Geerbt von Control)
ControlStyle

Ruft den Stil des Webserversteuerelements ab.Gets the style of the Web server control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde.Gets a value indicating whether a Style object has been created for the ControlStyle property. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is primarily used by control developers.

(Geerbt von WebControl)
CssClass

Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Geerbt von WebControl)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Geerbt von Control)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.Gets a value indicating whether a control is being used on a design surface.

(Geerbt von Control)
Enabled

Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether the Web server control is enabled.

(Geerbt von WebControl)
EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.Gets or sets a value indicating whether themes apply to this control.

(Geerbt von WebControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Geerbt von Control)
Font

Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind.Gets the font properties associated with the Web server control.

(Geerbt von WebControl)
ForeColor

Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Geerbt von WebControl)
HasAttributes

Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden.Gets a value indicating whether the control has attributes set.

(Geerbt von WebControl)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Geerbt von Control)
Height

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.Gets or sets the height of the Web server control.

(Geerbt von WebControl)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.Gets the character used to separate control identifiers.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.Gets a value indicating whether controls contained within this control have control state.

(Geerbt von Control)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.Gets a value indicating whether the control is enabled.

(Geerbt von WebControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the server control is saving changes to its view state.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.Gets a value indicating whether view state is enabled for this control.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Geerbt von Control)
OnClientClick

Ruft das clientseitige Skript ab, das ausgeführt wird, wenn für ein Button-Steuerelement ein Click-Ereignis ausgelöst wird, oder legt das clientseitige Skript fest.Gets or sets the client-side script that executes when a Button control's Click event is raised.

Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.Gets a reference to the Page instance that contains the server control.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.Gets a reference to the server control's parent control in the page control hierarchy.

(Geerbt von Control)
PostBackUrl

Ruft die URL der Seite ab, an die Daten von der aktuellen Seite gesendet werden sollen, wenn auf das Button-Steuerelement geklickt wird, oder legt diese fest.Gets or sets the URL of the page to post to from the current page when the Button control is clicked.

RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Geerbt von Control)
Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.Gets information about the container that hosts the current control when rendered on a design surface.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.Gets or sets the skin to apply to the control.

(Geerbt von WebControl)
Style

Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Geerbt von WebControl)
TabIndex

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.Gets or sets the tab index of the Web server control.

(Geerbt von WebControl)
TagKey

Ruft den HtmlTextWriterTag-Wert ab, der diesem Webserversteuerelement entspricht.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
TagName

Ruft den Namen des Steuerelementtags ab.Gets the name of the control tag. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.This property is used primarily by control developers.

(Geerbt von WebControl)
TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.Gets or sets a reference to the template that contains this control.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Geerbt von Control)
Text

Ruft den im Button-Steuerelement angezeigten Beschriftungstext ab, oder legt diesen fest.Gets or sets the text caption displayed in the Button control.

ToolTip

Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Geerbt von WebControl)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.Gets the unique, hierarchically qualified identifier for the server control.

(Geerbt von Control)
UseSubmitBehavior

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob das Button-Steuerelement den Sendemechanismus des Clientbrowsers oder den Postbackmechanismus von ASP.NET verwendet.Gets or sets a value indicating whether the Button control uses the client browser's submit mechanism or the ASP.NET postback mechanism.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Geerbt von Control)
ValidationGroup

Ruft die Gruppe von Steuerelementen ab, für die das Button-Steuerelement eine Validierung erfordert, wenn es Daten an den Server zurücksendet, oder legt diese fest.Gets or sets the group of controls for which the Button control causes validation when it posts back to the server.

ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.Gets a value that indicates whether the StateBag object is case-insensitive.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.Gets or sets the view-state mode of this control.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Geerbt von Control)
Width

Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest.Gets or sets the width of the Web server control.

(Geerbt von WebControl)

Methoden

AddAttributesToRender(HtmlTextWriter)

Fügt die Attribute eines Button-Steuerelements zum Ausgabestream hinzu, der auf dem Client gerendert werden soll.Adds the attributes of the Button control to the output stream for rendering on the client.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.Called after a child control is added to the Controls collection of the Control object.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Geerbt von Control)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is primarily used by control developers.

(Geerbt von WebControl)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.Applies the style properties defined in the page style sheet to the control.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.Begins design-time tracing of rendering data.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.Sets the cached ClientID value to null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.Deletes the control-state information for the server control's child controls.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state and control-state information for all the server control's child controls.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state information for all the server control's child controls.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Geerbt von Control)
CopyBaseAttributes(WebControl)

Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Geerbt von Control)
CreateControlStyle()

Erstellt das Formatvorlagenobjekt, das von der WebControl-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird.Creates the style object that is used internally by the WebControl class to implement all style related properties. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.Binds a data source to the invoked server control and all its child controls.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.Binds a data source to the server control's child controls.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.Enables a server control to perform final clean up before it is released from memory.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.Ends design-time tracing of rendering data.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines whether the server control contains child controls. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.If it does not, it creates child controls.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.Creates an identifier for controls that do not have an identifier assigned.

(Geerbt von Control)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.Sets input focus to a control.

(Geerbt von Control)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.Gets design-time data for a control.

(Geerbt von Control)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetPostBackOptions()

Erstellt ein PostBackOptions-Objekt, das das Postbackverhalten des Button-Steuerelements darstellt.Creates a PostBackOptions object that represents the Button control's postback behavior.

GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.Returns the prefixed portion of the UniqueID property of the specified control.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines if the server control contains any child controls.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.Returns a value indicating whether events are registered for the control or any child controls.

(Geerbt von Control)
IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.Determines if the server control holds only literal content.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Geerbt von Control)
LoadViewState(Object)

Stellt die Informationen über den Ansichtszustand aus einer früheren Anforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Geerbt von WebControl)
MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Geerbt von Control)
OnClick(EventArgs)

Löst das Click-Ereignis des Button-Steuerelements aus.Raises the Click event of the Button control.

OnCommand(CommandEventArgs)

Löst das Command-Ereignis des Button-Steuerelements aus.Raises the Command event of the Button control.

OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.Raises the DataBinding event.

(Geerbt von Control)
OnInit(EventArgs)

Löst das Init-Ereignis aus.Raises the Init event.

(Geerbt von Control)
OnLoad(EventArgs)

Löst das Load-Ereignis aus.Raises the Load event.

(Geerbt von Control)
OnPreRender(EventArgs)

Bestimmt, ob vor dem Rendern auf dem Client auf die Schaltfläche geklickt wurde.Determines whether the button has been clicked prior to rendering on the client.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.Raises the Unload event.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.Gets a Stream used to read a file.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

(Geerbt von Control)
RaisePostBackEvent(String)

Löst Ereignisse für das Button-Steuerelement aus, wenn es ein Postback an den Server ausführt.Raises events for the Button control when it posts back to the server.

RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.Called after a child control is removed from the Controls collection of the Control object.

(Geerbt von Control)
Render(HtmlTextWriter)

Gibt das Steuerelement im angegebenen HTML-Writer wieder.Renders the control to the specified HTML writer.

(Geerbt von WebControl)
RenderBeginTag(HtmlTextWriter)

Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder.Renders the HTML opening tag of the control to the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt des Steuerelements im angegebenen Writer.Renders the contents of the control to the specified writer.

RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Geerbt von Control)
RenderEndTag(HtmlTextWriter)

Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar.Renders the HTML closing tag of the control into the specified writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.This method is used primarily by control developers.

(Geerbt von WebControl)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.Gets the control adapter responsible for rendering the specified control.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.Gets a URL that can be used by the browser.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.Converts a URL into one that is usable on the requesting client.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Geerbt von Control)
SaveViewState()

Speichert jeden Zustand, der nach dem Aufrufen der TrackViewState()-Methode geändert wurde.Saves any state that was modified after the TrackViewState() method was invoked.

(Geerbt von WebControl)
SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.Sets design-time data for a control.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.Assigns an event handler delegate to render the server control and its content into its parent control.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TrackViewState()

Bewirkt, dass das Steuerelement die Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Objekts gespeichert werden können.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Geerbt von WebControl)

Ereignisse

Click

Tritt ein, wenn auf das Steuerelement Button geklickt wird.Occurs when the Button control is clicked.

Command

Tritt ein, wenn auf das Steuerelement Button geklickt wird.Occurs when the Button control is clicked.

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.Occurs when the server control binds to a data source.

(Geerbt von Control)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Geerbt von Control)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.Occurs when the server control is loaded into the Page object.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.Occurs after the Control object is loaded but prior to rendering.

(Geerbt von Control)
Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.Occurs when the server control is unloaded from memory.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.Gets an attribute of the Web control with the specified name.

(Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)

Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest.Sets an attribute of the Web control to the specified name and value.

(Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.For a description of this member, see ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().For a description of this member, see GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.For a description of this member, see UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.For a description of this member, see DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.For a description of this member, see HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.For a description of this member, see Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.For a description of this member, see HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Geerbt von Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Löst Ereignisse für das Button-Steuerelement aus, wenn es ein Postback an den Server ausführt.Raises events for the Button control when it posts back to the server.

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.Returns the metatable object for the containing data control.

Gilt für:

Siehe auch