共用方式為


DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 方法

定義

在集合中的指定索引處插入資料行。

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 -> unit
Public Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)

參數

columnIndex
Int32

要插入指定資料行之以零起始的索引。

dataGridViewColumn
DataGridViewColumn

要插入的 DataGridViewColumn

例外狀況

dataGridViewColumnnull

相關聯的 DataGridView 控制項正在執行下列其中一個動作,暫時阻止加入新的資料行:

  • 選取控制項中的所有儲存格。

  • 清除選取範圍。

  • 更新資料行 DisplayIndex 屬性值。

-或-

針對下列其中一個 DataGridView 事件 ,從處理常式呼叫這個方法:

-或-

dataGridViewColumn 已經屬於 DataGridView 控制項。

-或-

dataGridViewColumn SortMode 屬性值為 Automatic,而 SelectionMode 屬性值為 FullColumnSelectColumnHeaderSelect。 使用控制項 ISupportInitialize.BeginInit()ISupportInitialize.EndInit() 方法,暫時設定衝突的屬性值。

-或-

dataGridViewColumn InheritedAutoSizeMode 屬性值為 ColumnHeader,而 ColumnHeadersVisible 屬性值為 false

-或-

dataGridViewColumn 具有 InheritedAutoSizeMode 屬性值 FillFrozen 屬性值 true

-或-

dataGridViewColumn 具有的 DisplayIndexFrozen 屬性值,會將其顯示在一組具有相反 Frozen 屬性值的相鄰資料行之間。

-或-

DataGridView 控制項至少包含一個資料列,且 dataGridViewColumn 具有 CellType 屬性值 null

範例

下列程式碼範例說明此方法的使用方式。 如需詳細資訊,請參閱如何:將未系結資料行新增至 Data-Bound Windows Forms DataGridView 控制項

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

適用於

另請參閱