Aracılığıyla paylaş


ButtonField Sınıf

Tanım

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

Ö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 GridViewDetailsView) 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 RowCommandDetailsView 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 TextButton 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

Ayrıca bkz.