Udostępnij za pośrednictwem


ButtonField Klasa

Definicja

Reprezentuje pole, które jest wyświetlane jako przycisk w kontrolce powiązanej z danymi.

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
Dziedziczenie

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ButtonField obiektu do wyświetlania kolumny przycisków poleceń w kontrolce GridView .


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

Uwagi

Klasa ButtonField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView) do wyświetlania przycisku dla każdego wyświetlanego rekordu. Obiekt ButtonField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używana. Na przykład kontrolka GridView wyświetla ButtonField obiekt jako kolumnę, a kontrolka DetailsView wyświetla ją jako wiersz.

Kliknięcie przycisku w polu przycisku powoduje podniesienie zdarzenia polecenia kontrolki powiązanej z danymi nadrzędnymi. Możesz podać niestandardową procedurę do wykonania po kliknięciu przycisku polecenia, podając procedurę obsługi zdarzeń dla zdarzenia polecenia.

Uwaga

Kontrolka GridView zgłasza RowCommand zdarzenie, podczas gdy kontrolka DetailsView zgłasza ItemCommand zdarzenie.

Aby określić indeks rekordu, który zgłasza zdarzenie polecenia, użyj CommandArgument właściwości argumentu zdarzenia przekazanego do zdarzenia polecenia dla kontrolki powiązanej z danymi. Klasa ButtonField automatycznie wypełnia CommandArgument właściwość odpowiednią wartością indeksu.

Aby określić typ przycisku do wyświetlenia, użyj ButtonType właściwości . Podczas wyświetlania linku lub przycisku polecenia użyj Text właściwości , aby określić podpis do wyświetlenia w przyciskach.

Uwaga

Jeśli właściwość zostanie ustawionaText, wszystkie przyciski w ButtonField udziale będą takie same podpis.

Alternatywnie można powiązać ButtonField obiekt z polem w źródle danych. Dzięki temu można wyświetlać różne podpisy dla przycisków w ButtonField obiekcie. Wartości, które znajdują się w określonym polu, są używane dla podpisów tekstowych przycisków. DataTextField Ustaw właściwość na powiązanie ButtonField obiektu z polem w źródle danych.

Podczas wyświetlania przycisku obrazu użyj ImageUrl właściwości , aby określić obraz do wyświetlenia przycisków w ButtonField obiekcie.

Uwaga

Wszystkie przyciski w ButtonField obiekcie mają ten sam obraz.

Obiekt można ukryć ButtonField w kontrolce powiązanej z danymi, ustawiając Visible właściwość na false.

Obiekt ButtonField umożliwia dostosowanie sekcji nagłówka i stopki. Aby wyświetlić podpis w sekcji nagłówka lub stopki, ustaw HeaderText odpowiednio właściwości lubFooterText. Zamiast wyświetlać tekst w sekcji nagłówka, możesz wyświetlić obraz, ustawiając HeaderImageUrl właściwość. Aby ukryć sekcję nagłówka ButtonField w obiekcie, ustaw ShowHeader właściwość na false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą wyświetlać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola przycisku. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi (jeśli jest dostępna), użyj ShowHeader właściwości kontrolki.

Możesz również dostosować wygląd ButtonField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.

Właściwość Stylu Ustawienia stylu dla
ControlStyle Podrzędny serwer sieci Web kontroluje ButtonFieldelement .
FooterStyle Sekcja stopki .ButtonField
HeaderStyle Sekcja nagłówka .ButtonField
ItemStyle Elementy danych w obiekcie ButtonField.

Konstruktory

ButtonField()

Inicjuje nowe wystąpienie klasy ButtonField.

Właściwości

AccessibleHeaderText

Pobiera lub ustawia tekst renderowany jako AbbreviatedText wartość właściwości w niektórych kontrolkach.

(Odziedziczone po DataControlField)
ButtonType

Pobiera lub ustawia typ przycisku do wyświetlenia w polu przycisku.

(Odziedziczone po ButtonFieldBase)
CausesValidation

Pobiera lub ustawia wartość wskazującą, czy walidacja jest wykonywana po kliknięciu ButtonFieldBase przycisku w obiekcie.

(Odziedziczone po ButtonFieldBase)
CommandName

Pobiera lub ustawia ciąg reprezentujący akcję do wykonania po kliknięciu ButtonField przycisku w obiekcie.

Control

Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem.

(Odziedziczone po DataControlField)
ControlStyle

Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie.

(Odziedziczone po DataControlField)
DataTextField

Pobiera lub ustawia nazwę pola danych, dla którego wartość jest powiązana z Text właściwością Button kontrolki renderowanej przez ButtonField obiekt.

DataTextFormatString

Pobiera lub ustawia ciąg określający format wyświetlania dla wartości pola.

DesignMode

Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania.

(Odziedziczone po DataControlField)
FooterStyle

Pobiera lub ustawia styl stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
FooterText

Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderImageUrl

Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderStyle

Pobiera lub ustawia styl nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderText

Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
ImageUrl

Pobiera lub ustawia obraz do wyświetlenia dla każdego przycisku w ButtonField obiekcie.

InsertVisible

Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka powiązana z danymi jest w trybie wstawiania.

(Odziedziczone po DataControlField)
IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
ItemStyle

Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych.

(Odziedziczone po DataControlField)
ShowHeader

Pobiera lub ustawia wartość wskazującą, czy sekcja nagłówka jest wyświetlana ButtonFieldBase w obiekcie.

(Odziedziczone po ButtonFieldBase)
SortExpression

Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych.

(Odziedziczone po DataControlField)
Text

Pobiera lub ustawia statyczne podpis wyświetlane dla każdego przycisku w ButtonField obiekcie.

ValidateRequestMode

Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta.

(Odziedziczone po DataControlField)
ValidationGroup

Pobiera lub ustawia nazwę grupy kontrolek weryfikacji, aby sprawdzić, kiedy zostanie kliknięty przycisk w ButtonFieldBase obiekcie.

(Odziedziczone po ButtonFieldBase)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
Visible

Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane.

(Odziedziczone po DataControlField)

Metody

CloneField()

Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego.

(Odziedziczone po DataControlField)
CopyProperties(DataControlField)

Kopiuje właściwości bieżącego ButtonField obiektu do określonego DataControlField obiektu.

CreateField()

Tworzy i zwraca nowe wystąpienie ButtonField klasy.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Wyodrębnia wartość pola kontrolki danych z bieżącej komórki tabeli i dodaje wartość do określonej IDictionary kolekcji.

(Odziedziczone po DataControlField)
FormatDataTextValue(Object)

Formatuje określoną wartość pola dla komórki w ButtonField obiekcie.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
Initialize(Boolean, Control)

Inicjuje bieżący ButtonField obiekt.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicjuje określony DataControlFieldCell obiekt do określonego stanu wiersza.

LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku źródła danych.

(Odziedziczone po DataControlField)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnFieldChanged()

FieldChanged Zgłasza zdarzenie.

(Odziedziczone po DataControlField)
SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
ToString()

Zwraca ciąg reprezentujący ten DataControlField obiekt.

(Odziedziczone po DataControlField)
TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
ValidateSupportsCallback()

Określa, czy kontrolki zawarte w ButtonField obiekcie obsługują wywołania zwrotne.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem.

(Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku pola kontroli danych.

(Odziedziczone po DataControlField)
IStateManager.SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
IStateManager.TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)

Dotyczy

Zobacz też