DataGridTextBoxColumn 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在 TextBox 儲存格中裝載 DataGridColumnStyle 控制項以編輯字串。
public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStylepublic class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyletype DataGridTextBoxColumn = class
inherit DataGridColumnStylePublic Class DataGridTextBoxColumn
Inherits DataGridColumnStyle- 繼承
範例
下列範例會建立 ， DataGridTextBoxColumn 並將其新增至 GridColumnStylesCollection 的 DataGrid 。 若要執行此程式碼範例，請將它貼到具有 DataGrid 具名 dataGrid1 的表單中，並從 的 Form 建構函式呼叫它。
private:
void AddColumn()
{
DataTable^ myTable = gcnew DataTable;
// Add a new DataColumn to the DataTable.
DataColumn^ myColumn = gcnew DataColumn( "myTextBoxColumn" );
myColumn->DataType = System::Type::GetType( "System::String" );
myColumn->DefaultValue = "default string";
myTable->Columns->Add( myColumn );
// Get the CurrencyManager for the DataTable.
CurrencyManager^ cm = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
// Use the CurrencyManager to get the PropertyDescriptor for the new column.
System::ComponentModel::PropertyDescriptor^ pd = cm->GetItemProperties()[ "myTextBoxColumn" ];
DataGridTextBoxColumn^ myColumnTextColumn;
// Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = gcnew DataGridTextBoxColumn( pd );
// Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1->DataSource = myTable;
dataGrid1->TableStyles->Add( gcnew DataGridTableStyle );
dataGrid1->TableStyles[ 0 ]->GridColumnStyles->Add( myColumnTextColumn );
}
private void AddColumn()
{
DataTable myTable= new DataTable();
// Add a new DataColumn to the DataTable.
DataColumn myColumn = new DataColumn("myTextBoxColumn");
myColumn.DataType = System.Type.GetType("System.String");
myColumn.DefaultValue="default string";
myTable.Columns.Add(myColumn);
// Get the CurrencyManager for the DataTable.
CurrencyManager cm = (CurrencyManager)this.BindingContext[myTable];
// Use the CurrencyManager to get the PropertyDescriptor for the new column.
PropertyDescriptor pd = cm.GetItemProperties()["myTextBoxColumn"];
DataGridTextBoxColumn myColumnTextColumn;
// Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = new DataGridTextBoxColumn(pd);
// Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1.DataSource= myTable;
dataGrid1.TableStyles.Add(new DataGridTableStyle());
dataGrid1.TableStyles[0].GridColumnStyles.Add(myColumnTextColumn);
}
Private Sub AddColumn()
Dim myTable As New DataTable()
' Add a new DataColumn to the DataTable.
Dim myColumn As New DataColumn("myTextBoxColumn")
myColumn.DataType = System.Type.GetType("System.String")
myColumn.DefaultValue = "default string"
myTable.Columns.Add(myColumn)
' Get the CurrencyManager for the DataTable.
Dim cm As CurrencyManager = CType(Me.BindingContext(myTable), CurrencyManager)
' Use the CurrencyManager to get the PropertyDescriptor for the new column.
Dim pd As PropertyDescriptor = cm.GetItemProperties()("myTextBoxColumn")
Dim myColumnTextColumn As DataGridTextBoxColumn
' Create the DataGridTextBoxColumn with the PropertyDescriptor.
myColumnTextColumn = New DataGridTextBoxColumn(pd)
' Add the new DataGridColumn to the GridColumnsCollection.
dataGrid1.DataSource = myTable
dataGrid1.TableStyles.Add(New DataGridTableStyle())
dataGrid1.TableStyles(0).GridColumnStyles.Add(myColumnTextColumn)
End Sub
備註
類別 DataGridTextBoxColumn 衍生自 abstract 類別 DataGridColumnStyle 。 在執行時間，會 DataGridTextBoxColumn 裝載 DataGridTextBox 可讓使用者編輯文字的控制項。
新增至 類別的特殊屬性包括 Format 、 和 HideEditBox 。 這些屬性可讓您存取裝載 DataGridTextBox 的控制項及其屬性，並設定顯示值的格式。
如果資料來源是 DataTable 包含 DataColumn 的物件，則 DataType 的 DataColumn 屬性應該設定為資料類型，以邏輯方式在文字方塊控制項中編輯。 下列資料類型會自動與 ：、、、、、 DoubleInt64Int32UInt32UInt64UInt16Int16 、、 Single 和 String 相關聯。 DecimalDateTimeByteDataGridTextBoxColumn
建構函式
| DataGridTextBoxColumn() |
初始化 DataGridTextBoxColumn 類別的新執行個體。 |
| DataGridTextBoxColumn(PropertyDescriptor) |
使用指定的 PropertyDescriptor ，初始化 類別的新實例 DataGridTextBoxColumn 。 |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
使用指定的 DataGridTextBoxColumn，初始化 PropertyDescriptor 類別的新執行個體。 指定 DataGridTextBoxColumn 是否為預設的資料行。 |
| DataGridTextBoxColumn(PropertyDescriptor, String) |
使用指定的 PropertyDescriptor 和 格式， DataGridTextBoxColumn 初始化 類別的新實例。 |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
使用指定的 DataGridTextBoxColumn 和格式，初始化 PropertyDescriptor 類別的新執行個體。 指定資料行是否為預設資料行。 |
屬性
| Alignment |
取得或設定資料行中文字的對齊。 (繼承來源 DataGridColumnStyle) |
| CanRaiseEvents |
取得值，指出元件是否能引發事件。 (繼承來源 Component) |
| Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
| DataGridTableStyle |
取得資料行的 DataGridTableStyle。 (繼承來源 DataGridColumnStyle) |
| DesignMode |
取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| FontHeight |
取得資料行字型的高度。 (繼承來源 DataGridColumnStyle) |
| Format |
取得或設定字元，指定如何格式化文字。 |
| FormatInfo |
取得或設定特定的文化特性 (Culture) 資訊，用來決定如何格式化數值。 |
| HeaderAccessibleObject |
取得資料行的 AccessibleObject。 (繼承來源 DataGridColumnStyle) |
| HeaderText |
取得或設定資料行行首的文字。 (繼承來源 DataGridColumnStyle) |
| MappingName |
取得或設定要對應資料行樣式的資料成員名稱。 (繼承來源 DataGridColumnStyle) |
| NullText |
取得或設定當資料行包含 |
| PropertyDescriptor |
取得或設定 PropertyDescriptor 的 DataGridTextBoxColumn。 |
| ReadOnly |
設定數值，表示文字方塊資料行是否為唯讀。 |
| Site | (繼承來源 Component) |
| TextBox |
取得裝載的 TextBox 控制項。 |
| Width |
取得或設定資料行的寬度。 (繼承來源 DataGridColumnStyle) |
方法
事件
| AlignmentChanged |
發生在 Alignment 屬性值變更時。 (繼承來源 DataGridColumnStyle) |
| Disposed |
當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component) |
| FontChanged |
發生於資料行的字型變更時。 (繼承來源 DataGridColumnStyle) |
| HeaderTextChanged |
發生在 HeaderText 屬性值變更時。 (繼承來源 DataGridColumnStyle) |
| MappingNameChanged |
發生於 MappingName 值變更時。 (繼承來源 DataGridColumnStyle) |
| NullTextChanged |
發生於 NullText 值變更時。 (繼承來源 DataGridColumnStyle) |
| PropertyDescriptorChanged |
發生在 PropertyDescriptor 屬性值變更時。 (繼承來源 DataGridColumnStyle) |
| ReadOnlyChanged |
發生在 ReadOnly 屬性值變更時。 (繼承來源 DataGridColumnStyle) |
| WidthChanged |
發生在 Width 屬性值變更時。 (繼承來源 DataGridColumnStyle) |
明確介面實作
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
通知 DataGrid 控制項，使用者已開始編輯資料行。 (繼承來源 DataGridColumnStyle) |
