ButtonField.CommandName Özellik

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.

Nesnedeki bir düğmeye tıklandığında gerçekleştirilecek eylemi temsil eden bir ButtonField dizeyi alır veya ayarlar.

public:
 virtual property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };

public virtual string CommandName { get; set; }

member this.CommandName : string with get, set

Public Overridable Property CommandName As String

Özellik Değeri

String

içindeki bir düğmeye tıklandığında gerçekleştirilecek eylemin ButtonField adı.

Örnekler

Aşağıdaki kod örneği, bir denetimin nesnesindeki CommandName ButtonField düğmeler için bir komut adı belirtmek üzere özelliğinin GridView 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

CommandName veya "Remove"gibi "Add" bir komut adını nesnedeki ButtonField düğmelerle ilişkilendirmek için özelliğini kullanın. özelliğini, komut düğmesine tıklandığında gerçekleştirilecek eylemi tanımlayan herhangi bir dizeye ayarlayabilirsiniz CommandName . Daha sonra program aracılığıyla bir olay işleyicisindeki komut adını belirleyebilir ve uygun eylemleri gerçekleştirebilirsiniz.

Not

Nesnedeki ButtonField tüm düğmeler aynı komut adını paylaşır.

Veriye bağlı denetimler belirli komut adlarını tanır ve denetim için uygun olayları otomatik olarak oluşturur ve işler. Aşağıdaki komut adları tanınır:

"Cancel"
"Delete"
"Edit"
"Insert"
"New"
"Page"
"Select"
"Sort"
"Update"

Sayfalandırmayı çağırmak için, içindeki denetimin ve değerini , "Last", "Prev", "Next"veya sayfa numarası olarak ayarlayın CommandName"Page".CommandArgument"First"Button Ancak, bir ButtonField denetim için her zaman tamsayı satır dizini olduğundanCommandArgument, bir ButtonField denetim sayfalama çağırmak için uygun değildir. Benzer şekilde, olarak ayarlayarak CommandName"Sort"sıralamayı çağırabilirsiniz, ancak bir ButtonField denetimin CommandArgument özelliği her zaman tamsayı satır dizinidir. Bu nedenle, bir ButtonField denetim sıralamayı çağırmak için uygun değildir. ve "Remove"gibi "Add" özel komut adları için, komut adını denetlemek ve bazı özel eylemler gerçekleştirmek için olay kodunu yazmanız gerekir. Daha fazla bilgi için bkz. DataControlCommands.

Not

Tüm komut adları her veriye bağlı denetim tarafından tanınmaz. Örneğin, "New" denetim tarafından GridView tanınmaz ve "Select" denetim tarafından DetailsView tanınmaz.

Bu özelliğin değeri görünüm durumunda depolanır.

Şunlara uygulanır

Share via