Aracılığıyla paylaş


Button Sınıf

Tanım

Web sayfasında bir basma düğmesi denetimi görüntüler.

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

Örnekler

Aşağıdaki kod örneği, Web sayfası içeriğini sunucuya geri gönderen bir Gönder Button denetiminin nasıl oluşturulacağını gösterir.

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

Aşağıdaki kod örneği, listeyi sıralayan bir Komut Button denetiminin nasıl oluşturulacağını gösterir.

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

Açıklamalar

Bu konuda:

Giriş

Button Web sayfasında kullanıcıların sunucuya sayfa göndermesine olanak tanıyan bir anında iletme düğmesi oluşturmak için denetimi kullanın. Denetim, sunucu kodunda geri göndermeyi yanıtlamak için işleyebileceğiniz bir olayı tetikler. Ayrıca, istemci betiğinde sayfa gönderilmeden önce işleyebileceğiniz veya çalıştırılıp sayfanın gönderilmesini iptal eden bir olay oluşturabilir.

Not

ASP.NET, her biri Web sayfalarında farklı görünen çeşitli düğme denetimleri içerir. Button Bunlar bir basma düğmesi olarak işlenen denetim; LinkButton bağlantı olarak işlenen denetim ve ImageButton görüntü olarak işlenen denetim ve ImageMap kullanıcıların tıklayabileceği etkin noktaları olan bir grafik oluşturmanıza olanak tanıyan denetimdir. Varsayılan olarak, tüm düğme denetimleri tıklandığında sayfayı gönderir. Sayfada sunucu kodunda HtmlButton programlanabilir düğmeler oluşturmak için ve HtmlInputButton denetimlerini de kullanabilirsiniz. HTML ve Web sunucusu denetimleri arasındaki farklar hakkında ayrıntılı bilgi için bkz. ASP.NET Web Sunucusu Denetimlerine Genel Bakış.

Varsayılan olarak, Button denetim gönder düğmesidir. Gönder düğmesi, düğmeyle ilişkilendirilmiş bir komut adına (özelliği tarafından CommandName belirtilen) sahip değildir ve Web sayfasını sunucuya geri gönderir. Gönder düğmesine tıklandığında gerçekleştirilen eylemleri program aracılığıyla denetlemek için Click olaya yönelik bir olay işleyicisi sağlayabilirsiniz.

Komut düğmesi, Sortözelliği ayarlayarak CommandName düğmeyle ilişkilendirilmiş bir komut adına sahiptir. Bu, bir Web sayfasında birden çok Button denetim oluşturmanıza ve hangi Button denetimin tıklandığına program aracılığıyla karar vermenizi sağlar. Ayrıca, gerçekleştirilecek komut hakkında ek bilgi sağlamak için komutu düğmesiyle özelliğini de kullanabilirsiniz CommandArgument , örneğin Ascending. Komut düğmesine tıklandığında gerçekleştirilen eylemleri program aracılığıyla denetlemek için olay için Command bir olay işleyicisi sağlayabilirsiniz.

Düğme Geri Gönderme Davranışı ve Sunucu Olayları

Kullanıcı herhangi bir Web sunucusu denetimi düğmesine tıkladığında sayfa sunucuya gönderilir. Bu, Web sayfasının işlenmesine ve bekleyen olayların sunucu tabanlı kodda oluşmasına neden olur. Tüm sayfa ve denetim işlemleri tamamlandığında, sayfa kendisini yeniden tarayıcıya işler.

Düğmeler kendi Click olaylarını veya Command olaylarını oluşturabilir ve bunu sunucu tabanlı kod kullanarak işleyebilirsiniz. Bu, geleneksel HTML sayfalarındaki veya istemci tabanlı Web uygulamalarındaki olaylardan farklıdır. Burada onclick düğmenin olayı istemcide çalışan JavaScript kullanılarak işlenir. Daha fazla bilgi için bkz. ASP.NET Web Forms Server Denetim Olay Modeli.

Kullanıcılar bir düğme denetimine tıkladığında sayfa sunucuya geri gönderilir. Varsayılan olarak, sayfa kendisine geri gönderilir,

Geçerli sayfayı başka bir sayfaya göndermek için düğmeleri yapılandırabilirsiniz. Bu, çok sayfalı formlar oluşturmak için yararlı olabilir. Ayrıntılar için bkz. ASP.NET Web Formlarında Çapraz Sayfa Gönderme.

İstemci Betiğinde Düğme Olaylarını İşleme

Düğme denetimleri hem sunucu olaylarını hem de istemci olaylarını tetikleyebilir. Sunucu olayları geri göndermeden sonra gerçekleşir ve sayfa için yazdığınız sunucu tarafı kodunda işlenir. İstemci olayları genellikle ECMAScript (JavaScript) istemci betiğinde işlenir ve sayfa gönderilmeden önce tetiklenir. ASP.NET düğme denetimlerine istemci tarafı olayları ekleyerek, sayfayı göndermeden önce onay iletişim kutularını görüntüleme ve gönderimi iptal etme gibi görevleri gerçekleştirebilirsiniz. Ayrıntılar için bkz. ASP.NET Web Sayfalarında İstemci Betiği ve Nasıl yapılır: İstemci Betiğinde Düğme Web Sunucusu Denetim Olaylarını Yanıtlama.

Denetimin Button geri göndermeyi gerçekleştirmek için istemci betiğini de kullanmasını da isteyebilirsiniz (yalnızca HTTP POST işlemi gerçekleştirmek yerine). Bu, geri göndermeyi sayfadaki diğer öğelere eklemek gibi program aracılığıyla işlemek istiyorsanız yararlı olabilir. Denetimin özelliğinitrue, denetimin ButtonUseSubmitBehavior istemci betiği tabanlı geri göndermeyi kullanmasına neden Button olacak şekilde ayarlayabilirsiniz.

Düğme Denetimleri ve Doğrulama

Sayfada ASP.NET doğrulayıcı denetimi varsa, varsayılan olarak bir düğme denetimine tıklanması doğrulayıcı denetiminin denetimini gerçekleştirmesine neden olur. Doğrulayıcı denetimi için istemci tarafı doğrulama etkinleştirildiyse, doğrulama denetimi başarısız olursa sayfa gönderilmez.

Aşağıdaki tabloda, doğrulama işlemini daha hassas bir şekilde denetlemenizi sağlayan düğme denetimleri tarafından desteklenen özellikler açıklanmaktadır.

Özellik Açıklama
CausesValidation Düğmeye tıklanmasıyla doğrulama denetimi yapılıp yapılmayacağını belirtir. Doğrulama denetimini önlemek için bu özelliği olarak false ayarlayın.
ValidationGroup Düğmeye tıklandığında sayfadaki hangi doğrulayıcıların çağrılacağını belirtmenizi sağlar. Hiçbir doğrulama grubu oluşturulmazsa, bir düğmeye tıklandığında sayfadaki tüm doğrulayıcılar çağrılır.

Daha fazla bilgi için bkz . ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulama.

Veri Denetimlerindeki Düğmeler

Düğme Web sunucusu denetimleri genellikle , GridViewve Repeater liste denetimleri gibi veri denetimlerinde DataListkullanılır. Böyle durumlarda genellikle düğme tıklama olayına doğrudan yanıt vermezsiniz. Bunun yerine, veri denetimindeki bir düğme, veri denetimine özgü bir olayı tetikler. Örneğin, denetimde DataList bir düğme denetimin ItemCommandDataList olayını yükseltmek yerine denetimin ButtonClick olayını tetikler.

Veriye bağlı liste denetimleri birçok düğme içerebileceğinden, düğmenin CommandArgument özelliğini olayın bir parçası olarak geçirecek bir değer belirtecek şekilde ayarlayabilirsiniz. Ardından, hangi düğmeye tıklandığını görmek için bu bağımsız değişkeni test edebilirsiniz.

Denetimlere Veri Bağlama

Özellik ayarlarını dinamik olarak denetlemek için Web sunucusu denetimlerini bir veri kaynağına bağlayabilirsiniz. Örneğin, veri bağlamayı kullanarak bir düğmenin Text özelliğini ayarlayabilirsiniz.

UpdatePanel Denetimleriyle Düğmeleri Kullanma

Kısmi sayfa işleme, geri gönderme olmadan sayfanın bölümlerini yenilemeyi mümkün kılar. UpdatePanel denetimler, sayfanın kısmi sayfa işlemeye katılan bölümlerini işaretlemenizi sağlar. Varsayılan olarak, denetimler de dahil olmak üzere Button bir UpdatePanel denetim içindeki denetimlerin davranışı, geri gönderme yerine zaman uyumsuz bir geri gönderme gerçekleştirmektir. Bu, yalnızca geri göndermenin UpdatePanel kaynaklandığı denetimin içeriğini yeniler.

Bir denetimin içindeki denetim Button senaryosuna ek olarak, denetimleri aşağıdaki senaryolarda denetimlerle UpdatePanel birlikte kullanabilirsinizButton:UpdatePanel

  • Denetimin dışındaki bir ButtonUpdatePanel denetimi söz konusu panel için denetim AsyncPostBackTrigger olarak tanımlama. Düğmeye tıklandığında, zaman uyumsuz bir geri gönderme gerçekleştirir ve panelin içeriğini yeniler.

  • Button Bir denetimin içindeki bir UpdatePanel denetimi panel için olarak PostBackTrigger tanımlama. Düğmeye tıklandığında, bir denetimin içinde UpdatePanel olsa bile geri gönderme gerçekleştirir.

Kısmi sayfa işleme ve kullanma UpdatePanel denetimleri hakkında daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış ve Kısmi Sayfa İşlemeye Genel Bakış.

Tanımlayıcı Sözdizimi

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

Oluşturucular

Button()

Button sınıfının yeni bir örneğini başlatır.

Özellikler

AccessKey

Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar.

(Devralındığı yer: WebControl)
Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
Attributes

Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır.

(Devralındığı yer: WebControl)
BackColor

Web sunucusu denetiminin arka plan rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
BorderColor

Web denetiminin kenarlık rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderStyle

Web sunucusu denetiminin kenarlık stilini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderWidth

Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
CausesValidation

Denetime tıklandığında Button doğrulamanın gerçekleştirilip gerçekleştirilmediğini belirten bir değer alır veya ayarlar.

ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.

(Devralındığı yer: Control)
ClientIDMode

özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.

(Devralındığı yer: Control)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
CommandArgument

İlişkili CommandNameile birlikte olaya geçirilen Command isteğe bağlı bir parametreyi alır veya ayarlar.

CommandName

Olaya geçirilen Command denetimle Button ilişkili komut adını alır veya ayarlar.

Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
Controls

Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır.

(Devralındığı yer: Control)
ControlStyle

Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ControlStyleCreated

Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CssClass

İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar.

(Devralındığı yer: WebControl)
DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Enabled

Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableTheming

Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableViewState

Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip taşımadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
Font

Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır.

(Devralındığı yer: WebControl)
ForeColor

Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar.

(Devralındığı yer: WebControl)
HasAttributes

Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır.

(Devralındığı yer: WebControl)
HasChildViewState

Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Height

Web sunucusu denetiminin yüksekliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ID

Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsEnabled

Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: WebControl)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Control)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır.

(Devralındığı yer: Control)
OnClientClick

Denetimin olayı tetiklendiğinde ButtonClick yürütülen istemci tarafı betiğini alır veya ayarlar.

Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
PostBackUrl

Denetim tıklatıldığında geçerli sayfadan gönderilecek sayfanın URL'sini Button alır veya ayarlar.

RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak kaplamayı alır veya ayarlar.

(Devralındığı yer: WebControl)
Style

Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır.

(Devralındığı yer: WebControl)
SupportsDisabledAttribute

Denetimin özelliği falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: WebControl)
TabIndex

Web sunucusu denetiminin sekme dizinini alır veya ayarlar.

(Devralındığı yer: WebControl)
TagKey

HtmlTextWriterTag Bu Web sunucusu denetimine karşılık gelen değeri alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TagName

Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
Text

Denetimde Button görüntülenen metin başlığını alır veya ayarlar.

ToolTip

Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: WebControl)
UniqueID

Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
UseSubmitBehavior

Denetimin istemci tarayıcısının Button gönderme mekanizmasını mı yoksa ASP.NET geri gönderme mekanizmasını mı kullandığını belirten bir değer alır veya ayarlar.

ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ValidationGroup

Denetimin sunucuya geri gönderildiğinde doğrulamaya neden olduğu Button denetim grubunu alır veya ayarlar.

ViewState

Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Width

Web sunucusu denetiminin genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)

Yöntemler

AddAttributesToRender(HtmlTextWriter)

denetimin Button özniteliklerini istemcide işlemek üzere çıkış akışına ekler.

AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.

(Devralındığı yer: Control)
ApplyStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: Control)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini başlatır.

(Devralındığı yer: Control)
BuildProfileTree(String, Boolean)

Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim Trace eder.

(Devralındığı yer: Control)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
CopyBaseAttributes(WebControl)

Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: Control)
CreateControlStyle()

Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: Control)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
Dispose()

Sunucu denetiminin bellekten çıkmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde pathOffset belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da aramaya yardımcı olur. Yönteminin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını denetime ayarlar.

(Devralındığı yer: Control)
GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetPostBackOptions()

Denetimin Button geri gönderme davranışını temsil eden bir PostBackOptions nesne oluşturur.

GetRouteUrl(Object)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)

Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.

(Devralındığı yer: Control)
HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: Control)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini belirten bir değer döndürür.

(Devralındığı yer: Control)
IsLiteralContent()

Sunucu denetiminin yalnızca değişmez içeriği barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadViewState(Object)

yöntemiyle SaveViewState() kaydedilmiş önceki bir istekten görünüm durumu bilgilerini geri yükler.

(Devralındığı yer: WebControl)
MapPathSecure(String)

Mutlak veya göreli bir sanal yolun eşlendiğini fiziksel yolu alır.

(Devralındığı yer: Control)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MergeStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın kullanıcı arabirimi sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnClick(EventArgs)

Denetimin Click olayını tetikler Button .

OnCommand(CommandEventArgs)

Denetimin Command olayını tetikler Button .

OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnInit(EventArgs)

Olayı tetikler Init .

(Devralındığı yer: Control)
OnLoad(EventArgs)

Olayı tetikler Load .

(Devralındığı yer: Control)
OnPreRender(EventArgs)

İstemcide işlemeden önce düğmeye tıklanıp tıklanmamış olduğunu belirler.

OnPreRender(EventArgs)

Olayı tetikler PreRender .

(Devralındığı yer: Control)
OnUnload(EventArgs)

Olayı tetikler Unload .

(Devralındığı yer: Control)
OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RaisePostBackEvent(String)

Sunucuya Button geri gönderildiğinde denetim için olayları tetikler.

RemovedControl(Control)

Bir alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

Denetimi belirtilen HTML yazıcısına işler.

(Devralındığı yer: WebControl)
RenderBeginTag(HtmlTextWriter)

Denetimin HTML açma etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderContents(HtmlTextWriter)

Denetimin içeriğini belirtilen yazıcıya işler.

RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır.

(Devralındığı yer: Control)
RenderEndTag(HtmlTextWriter)

Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
SaveControlState()

Sayfa sunucuya geri gönderildiğinden bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SaveViewState()

Yöntemi çağrıldıktan sonra TrackViewState() değiştirilen tüm durumları kaydeder.

(Devralındığı yer: WebControl)
SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
SetTraceData(Object, Object)

İzleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
SetTraceData(Object, Object, Object)

İzlenen nesneyi, izleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Denetimin, nesnenin ViewState özelliğinde depolanabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur.

(Devralındığı yer: WebControl)

Ekinlikler

Click

Denetime Button tıklandığında gerçekleşir.

Command

Denetime Button tıklandığında gerçekleşir.

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
Disposed

ASP.NET bir sayfa istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir. Bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IAttributeAccessor.GetAttribute(String)

Belirtilen ada sahip Web denetiminin özniteliğini alır.

(Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web denetiminin özniteliğini belirtilen ada ve değere ayarlar.

(Devralındığı yer: WebControl)
IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Sunucuya Button geri gönderildiğinde denetim için olayları tetikler.

Uzantı Metotları

FindDataSourceControl(Control)

Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.

FindFieldTemplate(Control, String)

Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.

FindMetaTable(Control)

İçeren veri denetimi için meta tablo nesnesini döndürür.

Şunlara uygulanır

Ayrıca bkz.