ButtonColumn Klass

Definition

En kolumntyp för kontrollen DataGrid som innehåller en användardefinierad knapp.

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn
public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn
type ButtonColumn = class
    inherit DataGridColumn
Public Class ButtonColumn
Inherits DataGridColumn
Arv
ButtonColumn

Exempel

Följande kodexempel visar hur du använder ButtonColumn klassen i en DataGrid kontroll för att skapa Lägg till knappar.

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}
Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

Kommentarer

ButtonColumn Använd klassen i en DataGrid kontroll för att skapa en knapp som motsvarar varje rad i DataGrid kontrollen. Ange den undertext som visas i knapparna genom att ange egenskapen Text . Om du anger egenskapen Text delar alla knappar i ButtonColumn objektet samma bildtext. Du kan också binda knapparna ButtonColumn till ett fält i en datakälla. På så sätt kan du visa olika bildtexter för varje knapp. Värdena i det angivna fältet används för textrubriken. Ange egenskapen DataTextField för att binda ButtonColumn till ett fält i en datakälla.

Du kan formatera de undertexter som visas i knapparna genom att ange DataTextField egenskapen med en formateringssträng.

Om du klickar på knapparna i höjs ButtonColumnItemCommand händelsen. Du kan programmatiskt styra den åtgärd som utförs när knappen klickas genom att tillhandahålla en händelsehanterare för ItemCommand händelsen.

Som standard utförs inte sidvalidering när en knapp i ButtonColumn klickas. Sidvalidering avgör om de indatakontroller som är associerade med en valideringskontroll på sidan alla klarar valideringsreglerna som anges av verifieringskontrollen. Om du vill utföra sidvalidering när en knapp klickas anger du CausesValidation egenskapen till true.

Konstruktorer

Name Description
ButtonColumn()

Initierar en ny instans av ButtonColumn klassen.

Egenskaper

Name Description
ButtonType

Hämtar eller anger vilken typ av knapp som ska visas i ButtonColumn objektet.

CausesValidation

Hämtar eller anger ett värde som anger om verifieringen utförs när en knapp i ButtonColumn objektet klickas.

CommandName

Hämtar eller anger en sträng som representerar kommandot som ska utföras när en knapp i ButtonColumn objektet klickas.

DataTextField

Hämtar eller anger fältnamnet från en datakälla som ska bindas till ButtonColumn objektet.

DataTextFormatString

Hämtar eller anger strängen som anger visningsformatet för bildtexten i varje knapp.

DesignMode

Hämtar ett värde som anger om kolumnen är i designläge.

(Ärvd från DataGridColumn)
FooterStyle

Hämtar formategenskaperna för sidfotsavsnittet i kolumnen.

(Ärvd från DataGridColumn)
FooterText

Hämtar eller anger texten som visas i sidfotsavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderImageUrl

Hämtar eller anger platsen för en bild som ska visas i rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderStyle

Hämtar formategenskaperna för rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
HeaderText

Hämtar eller anger texten som visas i rubrikavsnittet i kolumnen.

(Ärvd från DataGridColumn)
IsTrackingViewState

Hämtar ett värde som avgör om DataGridColumn objektet är markerat för att spara dess tillstånd.

(Ärvd från DataGridColumn)
ItemStyle

Hämtar formategenskaperna för objektcellerna i kolumnen.

(Ärvd från DataGridColumn)
Owner

Hämtar kontrollen DataGrid som kolumnen är medlem i.

(Ärvd från DataGridColumn)
SortExpression

Hämtar eller anger namnet på fältet eller uttrycket som ska skickas till OnSortCommand(DataGridSortCommandEventArgs) metoden när en kolumn har valts för sortering.

(Ärvd från DataGridColumn)
Text

Hämtar eller anger undertexten som visas i objektets ButtonColumn knappar.

ValidationGroup

Hämtar eller anger den grupp av verifieringskontroller som ButtonColumn objektet orsakar validering för när det skickas tillbaka till servern.

ViewState

Hämtar objektet StateBag som tillåter att en kolumn som härleds DataGridColumn från klassen lagrar dess egenskaper.

(Ärvd från DataGridColumn)
Visible

Hämtar eller anger ett värde som anger om kolumnen visas i DataGrid kontrollen.

(Ärvd från DataGridColumn)

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
FormatDataTextValue(Object)

Konverterar det angivna värdet till det format som anges av egenskapen DataTextFormatString .

GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Initialize()

Återställer objektet ButtonColumn till dess ursprungliga tillstånd.

InitializeCell(TableCell, Int32, ListItemType)

Återställer en cell i objektet ButtonColumn till dess ursprungliga tillstånd.

LoadViewState(Object)

Läser in objektets DataGridColumn tillstånd.

(Ärvd från DataGridColumn)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnColumnChanged()

Anropar metoden OnColumnsChanged().

(Ärvd från DataGridColumn)
SaveViewState()

Sparar objektets aktuella tillstånd DataGridColumn .

(Ärvd från DataGridColumn)
ToString()

Returnerar strängrepresentationen av kolumnen.

(Ärvd från DataGridColumn)
TrackViewState()

Orsakar spårning av visningstillståndsändringar i serverkontrollen så att de kan lagras i serverkontrollens StateBag objekt.

(Ärvd från DataGridColumn)

Explicita gränssnittsimplementeringar

Name Description
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om kolumnen spårar visningstillståndsändringar.

(Ärvd från DataGridColumn)
IStateManager.LoadViewState(Object)

Läser in tidigare sparat tillstånd.

(Ärvd från DataGridColumn)
IStateManager.SaveViewState()

Returnerar ett objekt som innehåller tillståndsändringar.

(Ärvd från DataGridColumn)
IStateManager.TrackViewState()

Börjar spåra tillståndsändringar.

(Ärvd från DataGridColumn)

Gäller för

Se även