共用方式為


Windows Form DataGridView 控制項中的資料行型別

更新:2007 年 11 月

DataGridView 控制項使用數種資料行型別來顯示資訊,並讓使用者可以修改或新增資訊。

當您繫結 DataGridView 控制項,並將 AutoGenerateColumns 屬性設定為 true 時,會使用適合繫結資料來源所包含資料型別的預設資料行型別自動產生資料行。

您也可以自行建立任何資料行類別的執行個體,並將這些執行個體加入至 Columns 屬性所傳回的集合。您可建立這些執行個體做為未繫結的資料行,或者也可以用手動方式加以繫結。例如,在您想要使用別種型別的資料行來取代自動產生的某種型別資料行時,以手動方式繫結資料行就非常有用。

下表說明可以在 DataGridView 控制項中使用的各種資料行類別。

類別

描述

DataGridViewTextBoxColumn

與文字基礎的值搭配使用。當繫結至數字或字串時會自動產生。

DataGridViewCheckBoxColumn

BooleanCheckState 值搭配使用。當繫結至這些型別的值時會自動產生。

DataGridViewImageColumn

用來顯示影像。當繫結至位元組陣列、Image 物件或 Icon 物件時,便會自動產生。

DataGridViewButtonColumn

用來顯示儲存格中的按鈕。不會在繫結時自動產生。通常用來做為未繫結資料行。

DataGridViewComboBoxColumn

用來顯示儲存格中的下拉式清單。不會在繫結時自動產生。通常以手動方式繫結至資料。

DataGridViewLinkColumn

用來顯示儲存格中的連結。不會在繫結時自動產生。通常以手動方式繫結至資料。

您的自訂資料行型別

您可以建立自己的資料行類別,方法是繼承 DataGridViewColumn 類別或其中一個衍生類別,以提供自訂外觀、行為或裝載控制項。如需詳細資訊,請參閱 HOW TO:擴充儲存格和資料行的行為和外觀以自訂 Windows Form DataGridView 控制項中的儲存格和資料行

這些資料行型別在下列章節中有更詳細的說明。

DataGridViewTextBoxColumn

DataGridViewTextBoxColumn 是一般目的的資料行型別,與文字基礎的值 (例如數字和字串) 搭配使用。在編輯模式中,TextBox 控制項會顯示於現用儲存格,讓使用者可以修改儲存格值。

儲存格值會自動轉換為顯示的字串。會自動剖析使用者輸入或修改的值,以建立適當資料型別的儲存格值。您可以藉由處理 DataGridView 控制項的 CellFormattingCellParsing 事件自訂這些轉換。

資料行的儲存格值資料型別是在資料行的 ValueType 屬性中加以指定。

DataGridViewCheckBoxColumn

DataGridViewCheckBoxColumn 是與 BooleanCheckState 值搭配使用。而 Boolean 值會依 ThreeState 屬性值而定,顯示為兩種狀態或三種狀態的核取方塊。當資料行繫結至 CheckState 值時,根據預設 ThreeState 屬性值會為 true。

通常核取方塊值的目的是為了儲存 (例如任何其他資料) 或執行大量作業。如果您想要在使用者按一下核取方塊儲存格時立即回應,就可以處理 CellClick 事件,但這個事件是發生在更新儲存格值之前。如果您在按一下的時候需要新的值,有一個選擇是根據目前的值計算需要的值。另一種方法是立即認可變更,並處理 CellValueChanged 事件以做出回應。若要在按一下儲存格時認可變更,您必須處理 CurrentCellDirtyStateChanged 事件。在處理常式中,如果目前的儲存格是核取方塊儲存格,則呼叫 CommitEdit 方法,並傳入 Commit 值。

DataGridViewImageColumn

DataGridViewImageColumn 是用來顯示影像。影像資料行可從資料來源自動填入,可以用手動方式為未繫結資料行填入,或動態填入 CellFormatting 事件的處理常式。

資料來源的影像資料行的自動填入能使用於各種影像格式的位元組陣列,包括 Image 類別支援的所有格式,以及 Microsoft® Access 和 Northwind 範例資料庫的 OLE 圖片格式。

當您想提供 DataGridViewButtonColumn 的功能,但又要有自訂外觀時,以手動方式填入影像資料行會很有用。您可以處理 DataGridView.CellClick 事件以回應在影像儲存格內按選的動作。

當您想為計算值或非影像格式的值提供影像時,在 CellFormatting 事件的處理常式中填入影像資料行的儲存格,會是很有用的方式。例如,您可能有一個「風險」資料行,其中包含 "high"、"middle" 和 "low" 等您想要顯示為圖示的字串值。此外,也可能有「影像」資料行,其中包含的是必須載入的影像的位置,而非影像的二進位內容。

DataGridViewButtonColumn

藉由 DataGridViewButtonColumn,可以顯示包含按鈕的儲存格資料行。當您想為使用者提供在特定資料錄上執行動作的簡易方法 (例如在不同的視窗中下訂單或顯示子資料錄),這將會很有用。

當資料繫結 DataGridView 控制項時,不會自動產生按鈕資料行。若要使用按鈕資料行,您必須以手動方式加以建立,並將它們加入至 DataGridView.Columns 屬性傳回的集合。

您可以透過處理 DataGridView.CellClick 事件,回應使用者在按鈕儲存格中的按選動作。

DataGridViewComboBoxColumn

藉由 DataGridViewComboBoxColumn,您可以顯示包含下拉式清單方塊的儲存格資料行。若要在只能包含特定值的欄位中輸入資料 (例如,Northwind 範例資料庫中 Products 資料表的 Category 資料行),這會非常有用。

您可以使用填入 ComboBox 下拉式清單的相同方式,填入用於所有儲存格的下拉式清單;一種方法是透過 Items 屬性傳回的集合,以手動方式進行,另一種方法則是透過 DataSourceDisplayMemberValueMember 屬性,將清單繫結至資料來源。如需詳細資訊,請參閱 ComboBox 控制項 (Windows Form)

您可以繫結實際的儲存格值至 DataGridView 控制項所使用的資料來源,方法是設定 System.Windows.Forms.DataGridViewComboBoxColumnDataPropertyName 屬性。

下拉式方塊資料行不會在資料繫結 DataGridView 控制項時自動產生。若要使用下拉式方塊資料行,您必須以手動方式加以建立,並將它們加入至 Columns 屬性傳回的集合。

DataGridViewLinkColumn

藉由 DataGridViewLinkColumn,您可以顯示包含超連結的儲存格資料行。這對於資料來源中的 URL 值,或做為特殊行為 (例如使用子資料錄開啟視窗) 按鈕資料行的替代方法,都非常有用。

在資料繫結 DataGridView 控制項時不會自動產生連結資料行。若要使用連結資料行,您必須以手動方式加以建立,並將它們加入至 Columns 屬性傳回的集合。

您可以透過處理 CellContentClick 事件,回應使用者按選連結的動作。這個事件有別於 CellClickCellMouseClick 事件,後兩者是發生在使用者按選儲存格內的任何位置時。

DataGridViewLinkColumn 類別會提供數種屬性,可在按選連結前、按選連結的期間和按選連結後修改連結的外觀。

請參閱

工作

HOW TO:顯示 Windows Form DataGridView 控制項的儲存格影像

HOW TO:使用 Windows Form DataGridView 控制項中的影像資料行

參考

DataGridView

DataGridViewColumn

DataGridViewButtonColumn

DataGridViewCheckBoxColumn

DataGridViewComboBoxColumn

DataGridViewImageColumn

DataGridViewTextBoxColumn

DataGridViewLinkColumn

其他資源

DataGridView 控制項 (Windows Form)

自訂 Windows Form DataGridView 控制項