Button Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Geeft een besturingselement voor een drukknop weer op de webpagina.

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

Overname: Object

Control

WebControl
Button

Implementeringen: IPostBackEventHandler IButtonControl

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een besturingselement Verzenden Button maakt waarmee de inhoud van de webpagina wordt teruggezet naar de 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>

In het volgende codevoorbeeld ziet u hoe u een opdrachtbesturing Button maakt waarmee een lijst wordt gesorteerd.

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

Opmerkingen

In dit onderwerp:

Introduction
Gedrag van de knop Terugsturen en Server-gebeurtenissen
Knop gebeurtenissen verwerken in clientscript
Knopbesturingselementen en validatie
Knoppen in gegevensbesturingselementen
Gegevens binden aan de besturingselementen
Knoppen gebruiken met UpdatePanel-besturingselementen
Declaratieve syntaxis

Introduction

Gebruik het Button besturingselement om een drukknop te maken op de webpagina waarmee gebruikers een pagina naar de server kunnen posten. Het besturingselement activeert een gebeurtenis in servercode die u kunt afhandelen om te reageren op de postback. Het kan ook een gebeurtenis in clientscript genereren die u kunt afhandelen voordat de pagina wordt geplaatst of die kan worden uitgevoerd en vervolgens het indienen van de pagina annuleren.

Note

ASP.NET bevat verschillende soorten knopbesturingselementen, die allemaal verschillend worden weergegeven op webpagina's. Ze zijn het Button besturingselement, dat wordt weergegeven als een drukknop, het LinkButton besturingselement, dat wordt weergegeven als een koppeling, en het ImageButton besturingselement, dat wordt weergegeven als een afbeelding; en het ImageMap besturingselement, waarmee u een afbeelding kunt maken die hotspots bevat waarop gebruikers kunnen klikken. Standaard verzenden alle knopbesturingselementen de pagina wanneer erop wordt geklikt. U kunt de en HtmlInputButton besturingselementen ook gebruiken HtmlButton om knoppen te maken op de pagina die programmeerbaar zijn in servercode. Zie ASP.NET Web Server Controls Overview voor meer informatie over de verschillen tussen html- en webserverbesturingselementen.

Standaard is een Button besturingselement een knop Verzenden. Een knop Verzenden heeft geen opdrachtnaam (opgegeven door de CommandName eigenschap) die is gekoppeld aan de knop en plaatst de webpagina gewoon weer op de server. U kunt een gebeurtenis-handler voor de Click gebeurtenis opgeven om programmatisch de acties te beheren die worden uitgevoerd wanneer op de knop Verzenden wordt geklikt.

Een opdrachtknop heeft een opdrachtnaam die is gekoppeld aan de knop, bijvoorbeeld Sortdoor de eigenschap in te CommandName stellen. Hiermee kunt u meerdere Button besturingselementen op een webpagina maken en programmatisch bepalen op welk Button besturingselement wordt geklikt. U kunt de CommandArgument eigenschap ook gebruiken met een opdrachtknop om aanvullende informatie te geven over de opdracht die moet worden uitgevoerd, zoals Ascending. U kunt een gebeurtenis-handler opgeven om de Command acties die worden uitgevoerd via een programma te beheren wanneer op de opdrachtknop wordt geklikt.

Gedrag van de knop Terugsturen en Server-gebeurtenissen

Wanneer een gebruiker op een besturingselementknop webserver klikt, wordt de pagina naar de server verzonden. Hierdoor wordt de webpagina verwerkt en worden eventuele in behandeling zijnde gebeurtenissen gegenereerd in servercode. Wanneer de verwerking van alle pagina's en besturingselementen is voltooid, wordt de pagina weer in de browser weergegeven.

De knoppen kunnen hun eigen Click gebeurtenissen of Command gebeurtenissen genereren, die u kunt afhandelen met behulp van servercode. Dit verschilt van gebeurtenissen in traditionele HTML-pagina's of in webtoepassingen op basis van clients, waarbij de gebeurtenis van onclick een knop wordt verwerkt met behulp van JavaScript dat wordt uitgevoerd in de client. Zie ASP.NET Web Forms Server Control Event Model voor meer informatie.

Wanneer gebruikers op een besturingselement voor knoppen klikken, wordt de pagina teruggezet naar de server. Standaard wordt de pagina teruggezet naar zichzelf,

U kunt knoppen configureren om de huidige pagina op een andere pagina te plaatsen. Dit kan handig zijn voor het maken van formulieren met meerdere pagina's. Zie Cross-Page Posting in ASP.NET Web Forms voor meer informatie.

Knop gebeurtenissen verwerken in clientscript

Besturingselementen voor knoppen kunnen zowel server- als client-gebeurtenissen genereren. Servergebeurtenissen vinden plaats na het terugschrijven en ze worden verwerkt in de code aan de serverzijde die u voor de pagina schrijft. Clientgebeurtenissen worden verwerkt in clientscripts, meestal ECMAScript (JavaScript) en worden gegenereerd voordat de pagina wordt verzonden. Door gebeurtenissen aan de clientzijde toe te voegen aan ASP.NET knopbesturingselementen, kunt u taken uitvoeren, zoals het weergeven van bevestigingsdialoogvensters voordat u de pagina verzendt en de inzending mogelijk annuleren. Zie Client-script in ASP.NET webpagina's en Hoe to: Reageren op knopwebserverbesturingsevenementen in clientscript.

Mogelijk wilt u ook dat het Button besturingselement ook clientscript gebruikt om de postback uit te voeren (in plaats van gewoon een HTTP POST-bewerking uit te voeren). Dit kan handig zijn als u de postback programmatisch wilt bewerken, zoals het koppelen aan andere elementen op de pagina. U kunt de eigenschap true van UseSubmitBehavior het Button besturingselement zo instellen dat het Button besturingselement gebruikmaakt van postback op basis van clientscripts.

Knopbesturingselementen en validatie

Als een pagina ASP.NET validatorbesturingselementen bevat, zorgt het standaard ervoor dat het validatorbesturingselement op een knopbesturingselement de controle uitvoert. Als validatie aan de clientzijde is ingeschakeld voor een validatiebesturingselement, wordt de pagina niet verzonden als een validatiecontrole is mislukt.

In de volgende tabel worden de eigenschappen beschreven die worden ondersteund door knopbesturingselementen waarmee u het validatieproces nauwkeuriger kunt beheren.

Property	Description
CausesValidation	Hiermee geeft u op of op de knop ook een validatiecontrole wordt uitgevoerd. Stel deze eigenschap in om een validatiecontrole te `false` voorkomen.
ValidationGroup	Hiermee kunt u opgeven welke validators op de pagina worden aangeroepen wanneer op de knop wordt geklikt. Als er geen validatiegroepen tot stand zijn gebracht, roept een knop alle validators aan die zich op de pagina bevinden.

Zie Validating User Input in ASP.NET Webpagina's voor meer informatie.

Knoppen in gegevensbesturingselementen

Besturingselementen voor knopwebservers worden vaak gebruikt in gegevensbesturingselementen, zoals in de DataListbesturingselementen en GridView Repeater lijstbesturingselementen. In dergelijke gevallen reageert u doorgaans niet rechtstreeks op de knop op gebeurtenis. In plaats daarvan genereert een knop in een gegevensbeheer een gebeurtenis die specifiek is voor het gegevensbeheer. In het DataList besturingselement kan bijvoorbeeld een knop de gebeurtenis van ItemCommand het DataList besturingselement verhogen in plaats van de gebeurtenis van Click het Button besturingselement te verhogen.

Omdat gegevensgebonden lijstbesturingselementen veel knoppen kunnen bevatten, kunt u de eigenschap van CommandArgument de knop instellen om een waarde op te geven die moet worden doorgegeven als onderdeel van de gebeurtenis. U kunt vervolgens testen op dit argument om te zien op welke knop is geklikt.

Gegevens binden aan de besturingselementen

U kunt de besturingselementen van de knopwebserver koppelen aan een gegevensbron om de eigenschapsinstellingen dynamisch te beheren. U kunt bijvoorbeeld de eigenschap van Text een knop instellen met behulp van gegevensbinding.

Knoppen gebruiken met UpdatePanel-besturingselementen

Met gedeeltelijke paginaweergave kunt u delen van een pagina vernieuwen zonder een postback. UpdatePanel met besturingselementen kunt u delen van de pagina markeren die deelnemen aan het weergeven van gedeeltelijke pagina's. Standaard is het gedrag van besturingselementen in een UpdatePanel besturingselement, inclusief Button besturingselementen, het uitvoeren van een asynchrone postback in plaats van een postback. Hiermee wordt alleen de inhoud van het UpdatePanel besturingselement waarvan de terugpost afkomstig is, vernieuwd.

Naast het scenario van een besturingselement dat zich in een Button UpdatePanel besturingselement bevindt, kunt u besturingselementen gebruiken Button met UpdatePanel besturingselementen in de volgende scenario's:

Button Een besturingselement definiëren dat zich buiten een UpdatePanel besturingselement bevindt als een AsyncPostBackTrigger besturingselement voor dat paneel. Wanneer op de knop wordt geklikt, wordt een asynchrone postback uitgevoerd en wordt de inhoud van het deelvenster vernieuwd.
Button Een besturingselement definiëren dat zich in een UpdatePanel besturingselement bevindt als een PostBackTrigger voor het paneel. Wanneer op de knop wordt geklikt, wordt er een terugpost uitgevoerd, ook al bevindt deze zich in een UpdatePanel besturingselement.

Zie Overzicht van UpdatePanel-besturingselementen en Partial-Page Rendering-overzicht voor meer informatie over het weergeven van gedeeltelijke pagina's en het gebruik van UpdatePanel besturingselementen.

Declaratieve syntaxis

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

Constructors

Name	Description
Button()	Initialiseert een nieuw exemplaar van de Button klasse.

Eigenschappen

Name	Description
AccessKey	Hiermee haalt u de toegangssleutel op waarmee u snel naar het webserverbeheer kunt navigeren. (Overgenomen van WebControl)
Adapter	Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control)
AppRelativeTemplateSourceDirectory	Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control)
Attributes	Hiermee haalt u de verzameling willekeurige kenmerken (alleen voor rendering) op die niet overeenkomen met eigenschappen in het besturingselement. (Overgenomen van WebControl)
BackColor	Hiermee haalt u de achtergrondkleur van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BindingContainer	Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control)
BorderColor	Hiermee haalt u de randkleur van het web besturingselement op of stelt u deze in. (Overgenomen van WebControl)
BorderStyle	Hiermee haalt u de randstijl van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BorderWidth	Hiermee haalt u de randbreedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
CausesValidation	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de validatie wordt uitgevoerd wanneer op het Button besturingselement wordt geklikt.
ChildControlsCreated	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control)
ClientID	Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET. (Overgenomen van Control)
ClientIDMode	Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren. (Overgenomen van Control)
ClientIDSeparator	Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control)
CommandArgument	Hiermee haalt u een optionele parameter op die wordt doorgegeven aan de Command gebeurtenis, samen met de bijbehorende CommandName.
CommandName	Hiermee haalt u de opdrachtnaam op die is gekoppeld aan het Button besturingselement dat aan de Command gebeurtenis wordt doorgegeven.
Context	Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control)
Controls	Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van Control)
ControlStyle	Hiermee haalt u de stijl van het besturingselement webserver op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ControlStyleCreated	Hiermee wordt een waarde opgehaald die aangeeft of er een Style object is gemaakt voor de ControlStyle eigenschap. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
CssClass	Hiermee wordt de CSS-klasse (Cascading Style Sheet) opgehaald of ingesteld die wordt weergegeven door het webserverbeheer op de client. (Overgenomen van WebControl)
DataItemContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control)
DataKeysContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control)
Enabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement webserver is ingeschakeld. (Overgenomen van WebControl)
EnableTheming	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement. (Overgenomen van WebControl)
EnableViewState	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control)
Events	Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control)
Font	Hiermee haalt u de lettertype-eigenschappen op die zijn gekoppeld aan het besturingselement webserver. (Overgenomen van WebControl)
ForeColor	Hiermee haalt u de voorgrondkleur (meestal de kleur van de tekst) van het webserverbesturingselement op of stelt u deze in. (Overgenomen van WebControl)
HasAttributes	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement kenmerken heeft ingesteld. (Overgenomen van WebControl)
HasChildViewState	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control)
Height	Hiermee haalt u de hoogte van het webserverbeheer op of stelt u deze in. (Overgenomen van WebControl)
ID	Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control)
IdSeparator	Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control)
IsChildControlStateCleared	Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control)
IsEnabled	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement is ingeschakeld. (Overgenomen van WebControl)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control)
IsViewStateEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control)
LoadViewStateByID	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control)
NamingContainer	Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control)
OnClientClick	Hiermee wordt het script aan de clientzijde opgehaald of ingesteld dat wordt uitgevoerd wanneer de gebeurtenis van Click een Button besturingselement wordt gegenereerd.
Page	Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control)
Parent	Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control)
PostBackUrl	Hiermee wordt de URL van de pagina opgehaald of ingesteld om vanaf de huidige pagina te posten wanneer op het Button besturingselement wordt geklikt.
RenderingCompatibility	Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control)
Site	Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control)
SkinID	Hiermee wordt de huid op de controle toegepast of ingesteld. (Overgenomen van WebControl)
Style	Hiermee haalt u een verzameling tekstkenmerken op die worden weergegeven als een stijlkenmerk op de buitenste tag van het besturingselement webserver. (Overgenomen van WebControl)
SupportsDisabledAttribute	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het `disabled` kenmerk van het gerenderde HTML-element moet instellen op 'uitgeschakeld' wanneer de eigenschap van IsEnabled het besturingselement is `false`. (Overgenomen van WebControl)
TabIndex	Hiermee haalt u de tabindex van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
TagKey	Hiermee haalt u de HtmlTextWriterTag waarde op die overeenkomt met dit besturingselement van de webserver. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
TagName	Hiermee haalt u de naam van het besturingselementlabel op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
TemplateControl	Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control)
TemplateSourceDirectory	Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control)
Text	Hiermee wordt het tekstbijschrift opgehaald of ingesteld dat in het Button besturingselement wordt weergegeven.
ToolTip	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven wanneer de muisaanwijzer boven het besturingselement webserver beweegt. (Overgenomen van WebControl)
UniqueID	Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control)
UseSubmitBehavior	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het Button-besturingselement gebruikmaakt van het verzendmechanisme van de clientbrowser of het ASP.NET terugzendmechanisme.
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control)
ValidationGroup	Hiermee haalt u de groep besturingselementen op waarvoor het besturingselement validatie veroorzaakt wanneer het Button wordt teruggezet naar de server.
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control)
ViewStateIgnoresCase	Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control)
ViewStateMode	Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een serverbesturing wordt weergegeven als gebruikersinterface op de pagina. (Overgenomen van Control)
Width	Hiermee haalt u de breedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)

Methoden

Name	Description
AddAttributesToRender(HtmlTextWriter)	Voegt de kenmerken van het Button besturingselement toe aan de uitvoerstroom voor rendering op de client.
AddedControl(Control, Int32)	Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control)
AddParsedSubObject(Object)	Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control)
ApplyStyle(Style)	Kopieert eventuele niet-lege elementen van de opgegeven stijl naar het web besturingselement, en overschrijft eventuele bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ApplyStyleSheetSkin(Page)	De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van Control)
BeginRenderTracing(TextWriter, Object)	Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control)
BuildProfileTree(String, Boolean)	Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control)
ClearCachedClientID()	Hiermee stelt u de waarde in de cache in ClientID op `null`. (Overgenomen van Control)
ClearChildControlState()	Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildState()	Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildViewState()	Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearEffectiveClientIDMode()	Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control)
CopyBaseAttributes(WebControl)	Kopieert de eigenschappen die niet zijn ingekapseld door het Style object van het opgegeven webserverbesturingselement naar het webserverbesturingselement waaruit deze methode wordt aangeroepen. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
CreateChildControls()	Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control)
CreateControlCollection()	Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van Control)
CreateControlStyle()	Hiermee maakt u het stijlobject dat intern door de WebControl klasse wordt gebruikt om alle stijlgerelateerde eigenschappen te implementeren. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
DataBind()	Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control)
DataBind(Boolean)	Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control)
DataBindChildren()	Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
Dispose()	Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control)
EndRenderTracing(TextWriter, Object)	Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control)
EnsureChildControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control)
EnsureID()	Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindControl(String, Int32)	Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven `id` in de `pathOffset` parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven. (Overgenomen van Control)
FindControl(String)	Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven `id` parameter. (Overgenomen van Control)
Focus()	Hiermee stelt u de invoerfocus in op een besturingselement. (Overgenomen van Control)
GetDesignModeState()	Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetPostBackOptions()	Hiermee maakt u een PostBackOptions object dat het terugpostgedrag van het Button besturingselement vertegenwoordigt.
GetRouteUrl(Object)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(String, Object)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUniqueIDRelativeTo(Control)	Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control)
HasControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van Control)
HasEvents()	Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control)
IsLiteralContent()	Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control)
LoadControlState(Object)	Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control)
LoadViewState(Object)	Hiermee herstelt u informatie over de weergavestatus van een vorige aanvraag die is opgeslagen met de SaveViewState() methode. (Overgenomen van WebControl)
MapPathSecure(String)	Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MergeStyle(Style)	Kopieert niet-lege elementen van de opgegeven stijl naar het webbesturing, maar overschrijft geen bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
OnBubbleEvent(Object, EventArgs)	Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control)
OnClick(EventArgs)	Hiermee wordt de Click gebeurtenis van het Button besturingselement gegenereerd.
OnCommand(CommandEventArgs)	Hiermee wordt de Command gebeurtenis van het Button besturingselement gegenereerd.
OnDataBinding(EventArgs)	Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control)
OnInit(EventArgs)	Hiermee wordt de Init gebeurtenis gegenereerd. (Overgenomen van Control)
OnLoad(EventArgs)	Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control)
OnPreRender(EventArgs)	Bepaalt of de knop is geklikt voordat op de client wordt weergegeven.
OnPreRender(EventArgs)	Hiermee wordt de PreRender gebeurtenis gegenereerd. (Overgenomen van Control)
OnUnload(EventArgs)	Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control)
OpenFile(String)	Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control)
RaiseBubbleEvent(Object, EventArgs)	Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control)
RaisePostBackEvent(String)	Hiermee worden gebeurtenissen voor het Button besturingselement gegenereerd wanneer het terug naar de server wordt geplaatst.
RemovedControl(Control)	Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control)
Render(HtmlTextWriter)	Hiermee wordt het besturingselement weergegeven voor de opgegeven HTML-schrijver. (Overgenomen van WebControl)
RenderBeginTag(HtmlTextWriter)	Geeft de HTML-openingstag van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
RenderChildren(HtmlTextWriter)	Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderContents(HtmlTextWriter)	Geeft de inhoud van het besturingselement weer voor de opgegeven schrijver.
RenderControl(HtmlTextWriter, ControlAdapter)	De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control)
RenderControl(HtmlTextWriter)	Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van Control)
RenderEndTag(HtmlTextWriter)	Geeft de HTML-slottag van het besturingselement weer in de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ResolveAdapter()	Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control)
ResolveClientUrl(String)	Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control)
ResolveUrl(String)	Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control)
SaveControlState()	Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SaveViewState()	Hiermee wordt een status opgeslagen die is gewijzigd nadat de TrackViewState() methode is aangeroepen. (Overgenomen van WebControl)
SetDesignModeState(IDictionary)	Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control)
SetRenderMethodDelegate(RenderMethod)	Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control)
SetTraceData(Object, Object, Object)	Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
SetTraceData(Object, Object)	Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee zorgt u ervoor dat het besturingselement wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het object. (Overgenomen van WebControl)

gebeurtenis

Name	Description
Click	Treedt op wanneer op het Button besturingselement wordt geklikt.
Command	Treedt op wanneer op het Button besturingselement wordt geklikt.
DataBinding	Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control)
Disposed	Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control)
Init	Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control)
Load	Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control)
PreRender	Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control)
Unload	Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control)

Expliciete interface-implementaties

Name	Description
IAttributeAccessor.GetAttribute(String)	Hiermee haalt u een kenmerk van het webbeheer op met de opgegeven naam. (Overgenomen van WebControl)
IAttributeAccessor.SetAttribute(String, String)	Hiermee stelt u een kenmerk van het webbeheer in op de opgegeven naam en waarde. (Overgenomen van WebControl)
IControlBuilderAccessor.ControlBuilder	Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()	Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control)
IControlDesignerAccessor.UserData	Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control)
IDataBindingsAccessor.DataBindings	Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings	Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control)
IExpressionsAccessor.Expressions	Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control)
IExpressionsAccessor.HasExpressions	Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control)
IParserAccessor.AddParsedSubObject(Object)	Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Hiermee worden gebeurtenissen voor het Button besturingselement gegenereerd wanneer het terug naar de server wordt geplaatst.

Extensiemethoden

Name	Description
FindDataSourceControl(Control)	Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.
FindFieldTemplate(Control, String)	Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.
FindMetaTable(Control)	Retourneert het metatable-object voor het bevattende gegevensbeheer.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?