DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
在集合中給定的索引處插入欄位。
public:
virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual void Insert(int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unitPublic Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)參數
- columnIndex
- Int32
插入給定欄位的零基索引。
- dataGridViewColumn
- DataGridViewColumn
例外狀況
dataGridViewColumn 是 null。
相關的 DataGridView 控制項正在執行以下其中一項動作，暫時阻止新增欄位的加入：
選取控制組中的所有細胞。
清除選擇。
更新欄位 DisplayIndex 屬性值。
-或-
此方法由處理器呼叫，用於以下 DataGridView 事件之一：
-或-
dataGridViewColumn 已經屬於一個 DataGridView 控制組。
-或-
dataGridViewColumn
SortMode財產價值為 AutomaticSelectionMode ，財產價值為 FullColumnSelect 或 ColumnHeaderSelect。 使用控制項 ISupportInitialize.BeginInit() 和 ISupportInitialize.EndInit() 方法暫時設定衝突屬性值。
-或-
dataGridViewColumn
InheritedAutoSizeMode財產價值為 ColumnHeaderColumnHeadersVisible ，財產價值為 false。
-或-
dataGridViewColumn 具有 InheritedAutoSizeMode 一個屬性值為 Fill ，一個 Frozen 屬性值為 true。
-或-
dataGridViewColumn和DisplayIndexFrozen屬性值，這些值會將其顯示在相鄰欄位中，屬性值相反Frozen。
-或-
控制項DataGridView至少包含一列，屬性dataGridViewColumnCellType值為 null。
範例
以下程式碼範例說明此方法的使用。 欲了解更多資訊，請參見 How to： Add a Unbound Column to a Data-Bound Windows Forms DataGridView Control。
private void CreateUnboundButtonColumn()
{
// Initialize the button column.
DataGridViewButtonColumn buttonColumn =
new DataGridViewButtonColumn();
buttonColumn.Name = "Details";
buttonColumn.HeaderText = "Details";
buttonColumn.Text = "View Details";
// Use the Text property for the button text for all cells rather
// than using each cell's value as the text for its own button.
buttonColumn.UseColumnTextForButtonValue = true;
// Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn);
}
Private Sub CreateUnboundButtonColumn()
' Initialize the button column.
Dim buttonColumn As New DataGridViewButtonColumn
With buttonColumn
.HeaderText = "Details"
.Name = "Details"
.Text = "View Details"
' Use the Text property for the button text for all cells rather
' than using each cell's value as the text for its own button.
.UseColumnTextForButtonValue = True
End With
' Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn)
End Sub
