DataGridView.AutoResizeColumns 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

調整所有資料行的寬度，以適合其儲存格的內容。

多載

AutoResizeColumns()

調整所有資料行的寬度，以適合其所有儲存格的內容 (包括標題儲存格)。
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

使用指定的調整大小模式調整所有資料行的寬度。
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

使用指定的調整大小模式調整所有資料行的寬度，並在預期接下來將調整資料列高度的情況下，選擇性地計算寬度。

AutoResizeColumns()

調整所有資料行的寬度，以適合其所有儲存格的內容 (包括標題儲存格)。

public:
 void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()

範例

下列程式碼範例會調整所有資料行的大小，以符合資料行和資料行標頭的內容。 此程式碼範例是如何：以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

備註

如果您想要控制資料行調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料行寬度;如果資料行的內容稍後變更，資料行將不會自動調整。 若要調整特定資料行的大小，請使用 AutoResizeColumn 方法。 若要設定資料行在內容變更時自動調整大小，請使用 AutoSizeColumnsMode 屬性或資料行 AutoSizeMode 屬性。

如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。

另請參閱

適用於

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

使用指定的調整大小模式調整所有資料行的寬度。

public:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)

參數

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

其中一個 DataGridViewAutoSizeColumnsMode 值。

例外狀況

InvalidOperationException

autoSizeColumnsMode 具有值 ColumnHeader，且 ColumnHeadersVisible 為 false。

ArgumentException

autoSizeColumnsMode 具有值 None 或 Fill。

InvalidEnumArgumentException

autoSizeColumnsMode 不是有效的 DataGridViewAutoSizeColumnsMode 值。

範例

下列程式碼範例會調整所有資料行的大小，以符合資料行和資料行標頭的內容。 此程式碼範例是如何：以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}

private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}

Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

備註

如果您想要控制資料行調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料行寬度;如果資料行的內容稍後變更，資料行將不會自動調整。 若要調整特定資料行的大小，請使用 AutoResizeColumn 方法。 若要設定資料行在內容變更時自動調整大小，請使用 AutoSizeColumnsMode 屬性或資料行 AutoSizeMode 屬性。

此多載可讓您指定大小調整模式，根據一組有限儲存格中的值來計算新的寬度，例如僅顯示的資料列中的值。 當控制項包含大量資料列時，這可改善效能。

如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。

另請參閱

適用於

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

使用指定的調整大小模式調整所有資料行的寬度，並在預期接下來將調整資料列高度的情況下，選擇性地計算寬度。

protected:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns (System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)

參數

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

其中一個 DataGridViewAutoSizeColumnsMode 值。

fixedHeight
Boolean

true 表示根據目前的資料列高度來計算新的寬度；false 則表示在預期資料列高度也將會調整的情況下計算寬度。

例外狀況

InvalidOperationException

autoSizeColumnsMode 具有值 ColumnHeader，且 ColumnHeadersVisible 為 false。

ArgumentException

autoSizeColumnsMode 具有值 None 或 Fill。

InvalidEnumArgumentException

autoSizeColumnsMode 不是有效的 DataGridViewAutoSizeColumnsMode 值。

備註

如果您想要控制資料行調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料行寬度;如果資料行的內容稍後變更，資料行將不會自動調整。 若要調整特定資料行的大小，請使用 AutoResizeColumn 方法。 若要設定資料行在內容變更時自動調整大小，請使用 AutoSizeColumnsMode 屬性或資料行 AutoSizeMode 屬性。

此多載可讓您指定大小調整模式，根據一組有限儲存格中的值來計算新的寬度，例如僅顯示的資料列中的值。 當控制項包含大量資料列時，這可改善效能。

此多載受到保護，其設計目的是讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 如果 為 fixedHeight false ，則會計算資料行寬度，並預期您接下來會呼叫 AutoResizeRow 或 AutoResizeRows 方法。

如需程式設計調整大小的詳細資訊，請參閱dataGridView 控制項中的重設大小選項Windows Forms。

另請參閱

適用於