Button Klasa

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wyświetla kontrolkę przycisku push na stronie sieci Web.

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

Dziedziczenie: Object

Control

WebControl
Button

Implementuje: IPostBackEventHandler IButtonControl

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę Prześlij Button , która publikuje zawartość strony internetowej z powrotem na serwerze.

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

W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę Command Button , która sortuje 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"/>

       

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

Uwagi

W tym temacie:

Wprowadzenie
Zachowanie ogłaszania zwrotnego przycisku i zdarzenia serwera
Obsługa zdarzeń przycisku w skry skryptie klienta
Kontrolki przycisków i walidacja
Przyciski w kontrolkach danych
Wiązanie danych z kontrolkami
Używanie przycisków z kontrolkami UpdatePanel
Składnia deklaratywna

Introduction

Użyj kontrolki , Button aby utworzyć przycisk wypychania na stronie sieci Web, który umożliwia użytkownikom publikowanie strony na serwerze. Kontrolka wyzwala zdarzenie w kodzie serwera, które można obsłużyć w celu reagowania na postback. Może również zgłosić zdarzenie w skrycie klienta, które można obsłużyć przed opublikowaniem strony lub które można uruchomić, a następnie anulować przesyłanie strony.

Uwaga / Notatka

ASP.NET zawiera kilka rodzajów kontrolek przycisków, z których każda jest wyświetlana inaczej na stronach sieci Web. Są to kontrolka Button renderowana jako przycisk wypychania, LinkButton kontrolka renderowana jako link oraz ImageButton kontrolka renderowana jako obraz oraz ImageMap kontrolka, która umożliwia tworzenie grafiki zawierającej hotspoty, które użytkownicy mogą klikać. Domyślnie wszystkie kontrolki przycisku przesyłają stronę po kliknięciu. Za pomocą HtmlButton kontrolek i HtmlInputButton można również tworzyć przyciski na stronie, które są programowalne w kodzie serwera. Aby uzyskać szczegółowe informacje o różnicach między kontrolkami html i serwerem sieci Web, zobacz ASP.NET Web Server Controls Overview (Omówienie kontrolek serwera sieci Web w ASP.NET Web Server).

Domyślnie kontrolka jest przyciskiem Button Prześlij. Przycisk Prześlij nie ma nazwy polecenia (określonej przez CommandName właściwość) skojarzonej z przyciskiem i po prostu publikuje stronę internetową z powrotem na serwerze. Program obsługi Click zdarzeń umożliwia programowe sterowanie akcjami wykonywanymi po kliknięciu przycisku Prześlij.

Przycisk Polecenie ma nazwę polecenia skojarzona z przyciskiem, na przykład Sort, ustawiając CommandName właściwość . Dzięki temu można utworzyć wiele Button kontrolek na stronie sieci Web i programowo określić, która Button kontrolka jest klikana. Możesz również użyć CommandArgument właściwości z przyciskiem polecenia, aby podać dodatkowe informacje o poleceniu do wykonania, takie jak Ascending. Program obsługi Command zdarzeń umożliwia programowe sterowanie akcjami wykonywanymi po kliknięciu przycisku Polecenie.

Zachowanie ogłaszania zwrotnego przycisku i zdarzenia serwera

Gdy użytkownik kliknie dowolny przycisk kontroli serwera sieci Web, strona zostanie wysłana na serwer. Powoduje to przetworzenie strony sieci Web i wywoływanie wszystkich oczekujących zdarzeń w kodzie opartym na serwerze. Po zakończeniu przetwarzania wszystkich stron i kontrolek strona ponownie renderuje się w przeglądarce.

Przyciski mogą zgłaszać własne Click zdarzenia lub Command zdarzenia, które można obsłużyć przy użyciu kodu opartego na serwerze. Różni się to od zdarzeń na tradycyjnych stronach HTML lub w aplikacjach internetowych opartych na kliencie, gdzie zdarzenie przycisku onclick jest obsługiwane przy użyciu języka JavaScript działającego na kliencie. Aby uzyskać więcej informacji, zobacz ASP.NET Web Forms Server Control Event Model.

Gdy użytkownicy klikną kontrolkę przycisku, strona zostanie opublikowana z powrotem na serwerze. Domyślnie strona jest publikowana z powrotem do siebie,

Przyciski można skonfigurować tak, aby publikować bieżącą stronę na innej stronie. Może to być przydatne w przypadku tworzenia formularzy wielostronicowych. Aby uzyskać szczegółowe informacje, zobacz Publikowanie między stronami w formularzach internetowych ASP.NET.

Obsługa zdarzeń przycisku w skry skryptie klienta

Kontrolki przycisków mogą zgłaszać zdarzenia serwera i zdarzenia klienta. Zdarzenia serwera są wykonywane po powłoce i są obsługiwane w kodzie po stronie serwera, który piszesz dla strony. Zdarzenia klienta są obsługiwane w skrypcie klienta, zazwyczaj ECMAScript (JavaScript) i są wywoływane przed przekazaniem strony. Dodając zdarzenia po stronie klienta do kontrolek przycisków ASP.NET, można wykonywać zadania, takie jak wyświetlanie okien dialogowych potwierdzenia przed przesłaniem strony i potencjalnie anulowanie przesyłania. Aby uzyskać szczegółowe informacje, zobacz Skrypt klienta na stronach sieci Web ASP.NET i Instrukcje: Odpowiadanie na zdarzenia sterowania serwerem sieci Web w skrydcie klienta.

Możesz również chcieć, aby kontrolka Button korzystała również ze skryptu klienta do wykonania ogłaszania zwrotnego (zamiast wykonywać operację POST protokołu HTTP). Może to być przydatne, jeśli chcesz programowo manipulować ogłaszaniem zwrotnym, takim jak dołączenie go do innych elementów na stronie. Właściwość kontrolki UseSubmitBehavior można ustawić Button tak, aby true kontrolka korzystała z ogłaszania zwrotnego opartego Button na skryptach klienta.

Kontrolki przycisków i walidacja

Jeśli strona zawiera kontrolki modułu sprawdzania poprawności ASP.NET, domyślnie kliknięcie kontrolki przycisku powoduje, że kontrolka modułu sprawdzania poprawności wykonuje sprawdzanie. Jeśli walidacja po stronie klienta jest włączona dla kontrolki modułu sprawdzania poprawności, strona nie zostanie przesłana, jeśli sprawdzanie poprawności nie powiodło się.

W poniższej tabeli opisano właściwości obsługiwane przez kontrolki przycisków, które umożliwiają dokładniejsze sterowanie procesem weryfikacji.

Majątek	Opis
CausesValidation	Określa, czy kliknięcie przycisku wykonuje również sprawdzanie poprawności. Ustaw tę właściwość, aby `false` zapobiec sprawdzaniu poprawności.
ValidationGroup	Umożliwia określenie, które moduły sprawdzania poprawności na stronie są wywoływane po kliknięciu przycisku. Jeśli nie zostaną ustanowione żadne grupy sprawdzania poprawności, kliknij przycisk wywołuje wszystkie moduły sprawdzania poprawności, które znajdują się na stronie.

Aby uzyskać więcej informacji, zobacz Weryfikowanie danych wejściowych użytkownika w ASP.NET stronach sieci Web.

Przyciski w kontrolkach danych

Kontrolki serwera sieci Web przycisku są często używane w kontrolkach danych, takich jak w kontrolkach DataList, GridViewi Repeater listy. W takich przypadkach zwykle nie odpowiadasz bezpośrednio na zdarzenie kliknięcia przycisku. Zamiast tego przycisk w kontrolce danych zgłasza zdarzenie specyficzne dla kontrolki danych. Na przykład w kontrolce DataList przycisk może zgłosić DataList zdarzenie kontrolki ItemCommand zamiast podnieść Button zdarzenie kontrolki Click .

Ponieważ kontrolki listy powiązanej z danymi mogą zawierać wiele przycisków, można ustawić właściwość przycisku CommandArgument , aby określić wartość, która ma być przekazywana w ramach zdarzenia. Następnie możesz przetestować ten argument, aby zobaczyć, który przycisk został kliknięty.

Wiązanie danych z kontrolkami

Aby dynamicznie kontrolować ustawienia właściwości, można powiązać kontrolki serwera sieci Web ze źródłem danych. Można na przykład ustawić właściwość przycisku Text przy użyciu powiązania danych.

Używanie przycisków z kontrolkami UpdatePanel

Renderowanie częściowe strony umożliwia odświeżanie części strony bez ogłaszania zwrotnego. UpdatePanel kontrolki umożliwiają oznaczanie części strony, które uczestniczą w renderowaniu częściowej strony. Domyślnie zachowanie kontrolek wewnątrz UpdatePanel kontrolki, w tym Button kontrolek, polega na wykonaniu asynchronicznego ogłaszania zwrotnego zamiast ogłaszania zwrotnego. Spowoduje to odświeżenie tylko zawartości kontrolki, UpdatePanel z której pochodzi postback.

Oprócz scenariusza Button kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki, można użyć Button kontrolek z kontrolkami UpdatePanel w następujących scenariuszach:

Definiowanie kontrolki Button spoza kontrolki UpdatePanel jako AsyncPostBackTrigger kontrolki dla tego panelu. Kliknięcie przycisku spowoduje wykonanie asynchronicznego ogłaszania zwrotnego i odświeżenie zawartości panelu.
Definiowanie kontrolki Button , która znajduje się wewnątrz UpdatePanel kontrolki jako PostBackTrigger dla panelu. Po kliknięciu przycisku wykonuje ono ogłaszanie zwrotne, mimo że znajduje się wewnątrz kontrolki UpdatePanel .

Aby uzyskać więcej informacji na temat renderowania częściowego i używania UpdatePanel kontrolek, zobacz UpdatePanel Control Overview (Omówienie kontrolki UpdatePanel) i Partial-Page Rendering Overview (Omówienie renderowania).

Składnia deklaratywna

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

Konstruktory

Nazwa	Opis
Button()	Inicjuje nowe wystąpienie klasy Button.

Właściwości

Nazwa	Opis
AccessKey	Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl)
Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
Attributes	Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl)
BackColor	Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control)
BorderColor	Pobiera lub ustawia kolor obramowania kontrolki sieci Web. (Odziedziczone po WebControl)
BorderStyle	Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
BorderWidth	Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl)
CausesValidation	Pobiera lub ustawia wartość wskazującą, czy walidacja jest wykonywana po kliknięciu kontrolki Button .
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control)
ClientIDMode	Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości. (Odziedziczone po Control)
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości . (Odziedziczone po Control)
CommandArgument	Pobiera lub ustawia opcjonalny parametr przekazany do Command zdarzenia wraz ze skojarzonym parametrem CommandName.
CommandName	Pobiera lub ustawia nazwę polecenia skojarzona z kontrolką Button przekazywaną Command do zdarzenia.
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Control)
ControlStyle	Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ControlStyleCreated	Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości . Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CssClass	Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl)
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
Enabled	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl)
EnableTheming	Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl)
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
Font	Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl)
ForeColor	Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl)
HasAttributes	Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl)
HasChildViewState	Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącej kontrolki serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control)
Height	Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsEnabled	Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsViewStateEnabled	Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control)
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control)
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
OnClientClick	Pobiera lub ustawia skrypt po stronie klienta, który jest wykonywany po Button wystąpieniu zdarzenia kontrolki Click .
Page	Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontroli strony. (Odziedziczone po Control)
PostBackUrl	Pobiera lub ustawia adres URL strony do publikowania z bieżącej strony po kliknięciu kontrolki Button .
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
Site	Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera lub ustawia skórę do zastosowania do kontrolki. (Odziedziczone po WebControl)
Style	Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl)
SupportsDisabledAttribute	Pobiera wartość wskazującą, czy kontrolka powinna ustawić `disabled` atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled to `false`. (Odziedziczone po WebControl)
TabIndex	Pobiera lub ustawia indeks karty kontrolki serwera sieci Web. (Odziedziczone po WebControl)
TagKey	Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontrolce serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
TagName	Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
Text	Pobiera lub ustawia podpis tekstu wyświetlany w kontrolce Button .
ToolTip	Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl)
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
UseSubmitBehavior	Pobiera lub ustawia wartość wskazującą, czy Button kontrolka używa mechanizmu przesyłania przeglądarki klienta, czy mechanizmu ASP.NET ogłaszania zwrotnego.
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
ValidationGroup	Pobiera lub ustawia grupę kontrolek, dla których kontrolka Button powoduje walidację, gdy publikuje z powrotem na serwerze.
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisywanie i przywracanie stanu widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest bez uwzględniania wielkości liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control)
Width	Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl)

Metody

Nazwa	Opis
AddAttributesToRender(HtmlTextWriter)	Dodaje atrybuty kontrolki Button do strumienia wyjściowego do renderowania na kliencie.
AddedControl(Control, Int32)	Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control)
AddParsedSubObject(Object)	Powiadamia kontrolkę serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control)
ApplyStyle(Style)	Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control)
ClearCachedClientID()	Ustawia buforowana ClientID wartość na `null`. (Odziedziczone po Control)
ClearChildControlState()	Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildState()	Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control)
CopyBaseAttributes(WebControl)	Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
CreateChildControls()	Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control)
CreateControlCollection()	Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera. (Odziedziczone po Control)
CreateControlStyle()	Tworzy obiekt stylu używany wewnętrznie przez klasę WebControl do implementowania wszystkich właściwości powiązanych ze stylem. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi. (Odziedziczone po Control)
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control)
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control)
Dispose()	Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)	Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control)
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną `id` liczbą całkowitą określoną w parametrze `pathOffset` , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody. (Odziedziczone po Control)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego `id` parametru. (Odziedziczone po Control)
Focus()	Ustawia fokus danych wejściowych na kontrolkę. (Odziedziczone po Control)
GetDesignModeState()	Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetPostBackOptions()	Tworzy PostBackOptions obiekt, który reprezentuje Button zachowanie ogłaszania zwrotnego kontrolki.
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control)
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control)
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control)
IsLiteralContent()	Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control)
LoadControlState(Object)	Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control)
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania, które zostało zapisane za pomocą SaveViewState() metody . (Odziedziczone po WebControl)
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MergeStyle(Style)	Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control)
OnClick(EventArgs)	Click Wywołuje zdarzenie kontrolkiButton.
OnCommand(CommandEventArgs)	Command Wywołuje zdarzenie kontrolkiButton.
OnDataBinding(EventArgs)	DataBinding Wywołuje zdarzenie. (Odziedziczone po Control)
OnInit(EventArgs)	Init Wywołuje zdarzenie. (Odziedziczone po Control)
OnLoad(EventArgs)	Load Wywołuje zdarzenie. (Odziedziczone po Control)
OnPreRender(EventArgs)	Określa, czy przycisk został kliknięty przed renderowaniem na kliencie.
OnPreRender(EventArgs)	PreRender Wywołuje zdarzenie. (Odziedziczone po Control)
OnUnload(EventArgs)	Unload Wywołuje zdarzenie. (Odziedziczone po Control)
OpenFile(String)	Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control)
RaisePostBackEvent(String)	Zgłasza zdarzenia dla kontrolki Button , gdy publikuje z powrotem na serwerze.
RemovedControl(Control)	Wywoływana po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control)
Render(HtmlTextWriter)	Renderuje kontrolkę do określonego składnika zapisywania HTML. (Odziedziczone po WebControl)
RenderBeginTag(HtmlTextWriter)	Renderuje tag otwierający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
RenderChildren(HtmlTextWriter)	Zwraca zawartość elementów podrzędnych kontrolki serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderContents(HtmlTextWriter)	Renderuje zawartość kontrolki do określonego składnika zapisywania.
RenderControl(HtmlTextWriter, ControlAdapter)	Zwraca kontrolę zawartości serwera do dostarczonego obiektu przy użyciu podanego HtmlTextWriter ControlAdapter obiektu. (Odziedziczone po Control)
RenderControl(HtmlTextWriter)	Dane wyjściowe serwera kontrolują zawartość w podanym HtmlTextWriter obiekcie i przechowują informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)	Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl)
ResolveAdapter()	Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control)
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control)
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control)
SaveControlState()	Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control)
SaveViewState()	Zapisuje dowolny stan, który został zmodyfikowany po wywołaniu TrackViewState() metody. (Odziedziczone po WebControl)
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata programu obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control)
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia do śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
SetTraceData(Object, Object)	Ustawia dane śledzenia na potrzeby śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Powoduje, że kontrolka śledzi zmiany stanu widoku, aby można je było przechowywać we właściwości obiektu ViewState . (Odziedziczone po WebControl)

Zdarzenia

Nazwa	Opis
Click	Występuje po kliknięciu kontrolki Button .
Command	Występuje po kliknięciu kontrolki Button .
DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
Disposed	Występuje, gdy kontrolka serwera jest zwalniana z pamięci, który jest ostatnim etapem cyklu życia kontroli serwera, gdy żądana jest strona ASP.NET. (Odziedziczone po Control)
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)

Jawne implementacje interfejsu

Nazwa	Opis
IAttributeAccessor.GetAttribute(String)	Pobiera atrybut kontrolki sieci Web o określonej nazwie. (Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)	Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl)
IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder. (Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState(). (Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control)
IControlDesignerAccessor.UserData	Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control)
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control)
IExpressionsAccessor.Expressions	Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control)
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Zgłasza zdarzenia dla kontrolki Button , gdy publikuje z powrotem na serwerze.

Metody rozszerzania

Nazwa	Opis
FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.

Dotyczy

Zobacz też

Opinia

Czy ta strona była pomocna?