ButtonField Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

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: Object

DataControlField

ButtonFieldBase
ButtonField

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.

Konstruktorów

Nazwa	Opis
ButtonField()	Inicjuje nowe wystąpienie klasy ButtonField.

Właściwości

Nazwa	Opis
AccessibleHeaderText	Pobiera lub ustawia tekst renderowany jako `AbbreviatedText` wartość właściwości w niektórych kontrolkach. (Dziedziczone od DataControlField)
ButtonType	Pobiera lub ustawia typ przycisku do wyświetlenia w polu przycisku. (Dziedziczone od ButtonFieldBase)
CausesValidation	Pobiera lub ustawia wartość wskazującą, czy walidacja jest wykonywana po kliknięciu ButtonFieldBase przycisku w obiekcie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
ControlStyle	Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
FooterStyle	Pobiera lub ustawia styl stopki pola kontrolki danych. (Dziedziczone od DataControlField)
FooterText	Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderStyle	Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderText	Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych. (Dziedziczone od 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. (Dziedziczone od DataControlField)
IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od DataControlField)
ItemStyle	Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Dziedziczone od DataControlField)
ShowHeader	Pobiera lub ustawia wartość wskazującą, czy sekcja nagłówka jest wyświetlana ButtonFieldBase w obiekcie. (Dziedziczone od ButtonFieldBase)
SortExpression	Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych. (Dziedziczone od 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. (Dziedziczone od DataControlField)
ValidationGroup	Pobiera lub ustawia nazwę grupy kontrolek weryfikacji, aby sprawdzić, kiedy zostanie kliknięty przycisk w ButtonFieldBase obiekcie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Dziedziczone od DataControlField)

Metody

Nazwa	Opis
CloneField()	Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Dziedziczone od 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. (Dziedziczone od 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. (Dziedziczone od DataControlField)
FormatDataTextValue(Object)	Formatuje określoną wartość pola dla komórki w ButtonField obiekcie.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Dziedziczone od DataControlField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Dziedziczone od DataControlField)
ToString()	Zwraca ciąg reprezentujący ten DataControlField obiekt. (Dziedziczone od 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. (Dziedziczone od DataControlField)
ValidateSupportsCallback()	Określa, czy kontrolki zawarte w ButtonField obiekcie obsługują wywołania zwrotne.

Implementacje interfejsów jawnych

Nazwa	Opis
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Dziedziczone od DataControlField)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od DataControlField)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku pola kontroli danych. (Dziedziczone od DataControlField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Dziedziczone od 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. (Dziedziczone od DataControlField)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij przez

ButtonField Klasa

Definicja

Przykłady

Uwagi

Konstruktorów

Właściwości

Metody

Implementacje interfejsów jawnych

Dotyczy

Zobacz także

Sprzężenie zwrotne