ButtonField Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veriye bağlı denetimde düğme olarak görüntülenen bir alanı temsil eder.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase

public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase

type ButtonField = class
    inherit ButtonFieldBase

Public Class ButtonField
Inherits ButtonFieldBase

Devralma: Object

DataControlField

ButtonFieldBase
ButtonField

Örnekler

Aşağıdaki kod örneği, bir ButtonField denetimdeki GridView komut düğmeleri sütununu görüntülemek için bir nesnenin nasıl kullanılacağını gösterir.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + contact + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

Açıklamalar

sınıfı ButtonField , görüntülenen her kayıt için bir düğme görüntülemek üzere veriye bağlı denetimler (ve gibi GridView DetailsView) tarafından kullanılır. Nesne ButtonField , kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir ButtonField nesneyi sütun olarak görüntülerken DetailsView , denetim bunu satır olarak görüntüler.

Düğme alanındaki bir düğmeye tıklanması, üst veriye bağlı denetimin komut olayını tetikler. Komut olayı için bir olay işleyicisi sağlayarak bir komut düğmesine tıklandığında gerçekleştirilecek özel bir yordam sağlayabilirsiniz.

Not

Denetim GridView olayı tetiklerken RowCommand DetailsView denetim olayı tetikler ItemCommand .

Komut olayını oluşturan kaydın dizinini belirlemek için, veriye bağlı denetim için komut olayına geçirilen olay bağımsız değişkeninin özelliğini kullanın CommandArgument . sınıfı, ButtonField özelliği otomatik olarak uygun dizin değeriyle doldurur CommandArgument .

Görüntülenecek düğme türünü belirtmek için özelliğini kullanın ButtonType . Bağlantı veya komut düğmesi görüntülerken, düğmelerde görüntülenecek başlık belirtmek için özelliğini kullanınText.

Not

Özelliğini ayarlarsanızText, bir ButtonField içindeki tüm düğmeler aynı başlık paylaşır.

Alternatif olarak, nesneyi veri kaynağındaki ButtonField bir alana bağlayabilirsiniz. Bu, nesnedeki ButtonField düğmeler için farklı resim yazıları görüntülemenizi sağlar. Belirtilen alanda yer alan değerler, düğmelerin metin alt yazıları için kullanılır. Bir nesneyi veri kaynağındaki DataTextField bir ButtonField alana bağlamak için özelliğini ayarlayın.

Görüntü düğmesini görüntülerken, nesnedeki ImageUrl düğmeler ButtonField için görüntülenecek görüntüyü belirtmek üzere özelliğini kullanın.

Not

Nesnedeki ButtonField tüm düğmeler aynı görüntüyü paylaşır.

özelliğini falseolarak ayarlayarak Visible veriye bağlı denetimdeki bir ButtonField nesneyi gizleyebilirsiniz.

nesnesi, ButtonField üst bilgi ve alt bilgi bölümlerini özelleştirmenize olanak tanır. Üst bilgi veya alt bilgi bölümünde bir başlık görüntülemek için sırasıyla veya FooterText özelliklerini ayarlayınHeaderText. Üst bilgi bölümünde metin görüntülemek yerine, özelliğini ayarlayarak HeaderImageUrl bir görüntü görüntüleyebilirsiniz. Bir ButtonField nesnedeki üst bilgi bölümünü gizlemek için özelliğini olarak falseayarlayınShowHeader.

Not

Bazı veriye bağlı denetimler (denetim gibi) denetimin GridView yalnızca üst bilgi bölümünün tamamını gösterebilir veya gizleyebilir. Bu veriye bağlı denetimler tek bir düğme alanı için özelliğini desteklemez ShowHeader . Veriye bağlı denetimin üst bilgi bölümünün tamamını göstermek veya gizlemek için (varsa), denetimin ShowHeader özelliğini kullanın.

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin ButtonField görünümünü (yazı tipi rengi, arka plan rengi vb.) özelleştirebilirsiniz. Aşağıdaki tabloda farklı stil özellikleri listeılmıştır.

Style özelliği	Için stil ayarları
ControlStyle	öğesinin ButtonFieldalt Web sunucusu denetimleri.
FooterStyle	öğesinin ButtonFieldalt bilgi bölümü.
HeaderStyle	öğesinin ButtonFieldüst bilgi bölümü.
ItemStyle	içindeki ButtonFieldveri öğeleri.

Oluşturucular

ButtonField()

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

Özellikler

AccessibleHeaderText	Bazı denetimlerde özellik değeri olarak `AbbreviatedText` işlenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
ButtonType	Düğme alanında görüntülenecek düğme türünü alır veya ayarlar. (Devralındığı yer: ButtonFieldBase)
CausesValidation	Nesnedeki bir düğmeye tıklandığında doğrulamanın gerçekleştirilip gerçekleştirilmeyeceğini belirten bir ButtonFieldBase değer alır veya ayarlar. (Devralındığı yer: ButtonFieldBase)
CommandName	Nesnedeki bir düğmeye tıklandığında gerçekleştirilecek eylemi temsil eden bir ButtonField dizeyi alır veya ayarlar.
Control	Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır. (Devralındığı yer: DataControlField)
ControlStyle	Nesnenin içerdiği DataControlField web sunucusu denetimlerinin stilini alır. (Devralındığı yer: DataControlField)
DataTextField	Değerin nesnesi tarafından ButtonField işlenen denetimin özelliğine Text Button bağlı olduğu veri alanının adını alır veya ayarlar.
DataTextFormatString	Alanın değeri için görüntüleme biçimini belirten dizeyi alır veya ayarlar.
DesignMode	Bir veri denetim alanının şu anda bir tasarım zamanı ortamında görüntülenip görüntülenmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
FooterStyle	Veri denetim alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
FooterText	Veri denetim alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderImageUrl	Bir veri denetimi alanının üst bilgi öğesinde görüntülenen görüntünün URL'sini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderStyle	Veri denetim alanının üst bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderText	Veri denetim alanının üst bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
ImageUrl	Nesnedeki her düğme ButtonField için görüntülenecek görüntüyü alır veya ayarlar.
InsertVisible	Üst veri bağlı denetimi ekleme modundayken nesnenin DataControlField görünür olup olmadığını belirten bir değer alır. (Devralındığı yer: DataControlField)
IsTrackingViewState	Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
ItemStyle	Veri denetim alanı tarafından görüntülenen metin tabanlı içeriğin stilini alır. (Devralındığı yer: DataControlField)
ShowHeader	Üst bilgi bölümünün bir nesnede görüntülenip görüntülenmeyeceğini belirten bir ButtonFieldBase değer alır veya ayarlar. (Devralındığı yer: ButtonFieldBase)
SortExpression	Verileri sıralamak için veri kaynağı denetimi tarafından kullanılan bir sıralama ifadesi alır veya ayarlar. (Devralındığı yer: DataControlField)
Text	Nesnedeki her düğme ButtonField için görüntülenen statik başlık alır veya ayarlar.
ValidateRequestMode	Denetimin istemci girişini doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
ValidationGroup	Nesnedeki bir düğmeye ButtonFieldBase tıklandığında doğrulamak için doğrulama denetimleri grubunun adını alır veya ayarlar. (Devralındığı yer: ButtonFieldBase)
ViewState	Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum DataControlField bilgileri sözlüğü alır. (Devralındığı yer: DataControlField)
Visible	Veri denetim alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)

Yöntemler

CloneField()	Geçerli DataControlFieldtüretilmiş nesnenin yinelenen bir kopyasını oluşturur. (Devralındığı yer: DataControlField)
CopyProperties(DataControlField)	Geçerli ButtonField nesnenin özelliklerini belirtilen DataControlField nesneye kopyalar.
CreateField()	sınıfının yeni bir örneğini ButtonField oluşturur ve döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Geçerli tablo hücresinden veri denetimi alanının değerini ayıklar ve değeri belirtilen IDictionary koleksiyona ekler. (Devralındığı yer: DataControlField)
FormatDataTextValue(Object)	Nesnedeki bir hücre için belirtilen alan değerini biçimlendirin ButtonField .
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Initialize(Boolean, Control)	Geçerli ButtonField nesneyi başlatır.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Belirtilen nesneyi belirtilen DataControlFieldCell satır durumuna başlatır.
LoadViewState(Object)	Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnFieldChanged()	Olayı tetikler `FieldChanged` . (Devralındığı yer: DataControlField)
SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
ToString()	Bu DataControlField nesneyi temsil eden bir dize döndürür. (Devralındığı yer: DataControlField)
TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)
ValidateSupportsCallback()	Bir ButtonField nesnede bulunan denetimlerin geri çağırmaları destekleyip desteklemediğini belirler.

Belirtik Arabirim Kullanımları

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar. (Devralındığı yer: DataControlField)
IStateManager.IsTrackingViewState	Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
IStateManager.LoadViewState(Object)	Veri denetimi alanının daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
IStateManager.SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
IStateManager.TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)

Şunlara uygulanır