DataGridView.AutoResizeRows 方法

public:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);

public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);

member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit

Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)

參數

例外狀況

範例

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

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}

private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}

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

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

備註

如果您想要控制資料列調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更，資料列將不會自動調整。 若要調整特定資料列的大小，請使用 AutoResizeRow 方法。 若要調整資料列子集的大小，請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小，請使用 AutoSizeRowsMode 屬性。

若要讓儲存格內容在重設資料列大小時換行到多行，儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。

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

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

另請參閱

• DataGridView 控制項 (Windows Form)

protected:
 void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);

protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);

member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit

Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

參數

例外狀況

備註

如果您想要控制資料列調整大小，但只想調整特定資料列子集的大小，例如已更新之系結記錄範圍內的資料列，這個方法很有用。 每個方法呼叫只會調整指定資料列的資料列高度一次;如果資料列的內容稍後變更，資料列將不會自動調整。 若要調整特定資料列的大小，請使用 AutoResizeRow 方法。 若要調整所有資料列的大小，請使用 方法的不同多載 AutoResizeRows 。 若要設定資料列在內容變更時自動調整大小，請使用 AutoSizeRowsMode 屬性。

若要讓儲存格內容在重設資料列大小時換行到多行，儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。

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

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

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

另請參閱

• DataGridView 控制項 (Windows Form)

public:
 void AutoResizeRows();

public void AutoResizeRows ();

member this.AutoResizeRows : unit -> unit

Public Sub AutoResizeRows ()

範例

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

void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}

private void SizeAllRows(Object sender,
    EventArgs e)
{
    dataGridView1.AutoResizeRows(
        DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}

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

    DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)

End Sub

備註

如果您想要控制資料列調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更，資料列將不會自動調整。 若要調整特定資料列的大小，請使用 AutoResizeRow 方法。 若要調整資料列子集的大小，請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小，請使用 AutoSizeRowsMode 屬性。

若要讓儲存格內容在重設資料列大小時換行到多行，儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。

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

另請參閱

• DataGridView 控制項 (Windows Form)

protected:
 void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);

protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);

member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit

Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)

參數

例外狀況

備註

如果您想要控制資料列調整大小時，這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更，資料列將不會自動調整。 若要調整特定資料列的大小，請使用 AutoResizeRow 方法。 若要調整資料列子集的大小，請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小，請使用 AutoSizeRowsMode 屬性。

若要讓儲存格內容在重設資料列大小時換行到多行，儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。

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

此多載受到保護，且旨在讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 fixedWidth如果 參數為 false ，則會計算資料列高度，並預期您接下來會呼叫 AutoResizeColumn 或 AutoResizeColumns 方法。

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

另請參閱

• DataGridView 控制項 (Windows Form)