DataGridView.AutoResizeRow 方法

  • 參考

定義

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

調整指定資料列的高度，以適合其儲存格的內容。

多載

AutoResizeRow(Int32)

調整指定資料列的高度，以適合其所有儲存格的內容 (包括標題儲存格)。
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

使用指定的調整大小模式調整指定資料列的高度。
AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

AutoResizeRow(Int32)

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

public:
 void AutoResizeRow(int rowIndex);
public void AutoResizeRow (int rowIndex);
member this.AutoResizeRow : int -> unit
Public Sub AutoResizeRow (rowIndex As Integer)

參數

rowIndex
Int32

要調整大小之資料列的索引。

例外狀況

ArgumentOutOfRangeException

rowIndex 不在 0 到資料列數目減 1 的有效範圍內。

範例

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

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}

private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}

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

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

備註

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

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

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

另請參閱

適用於

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode)

使用指定的調整大小模式調整指定資料列的高度。

public:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode);
public void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode -> unit
Public Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode)

參數

rowIndex
Int32

要調整大小之資料列的索引。

autoSizeRowMode
DataGridViewAutoSizeRowMode

其中一個 DataGridViewAutoSizeRowMode 值。

例外狀況

InvalidOperationException

autoSizeRowMode 具有值 RowHeader，且 RowHeadersVisible 為 false。

InvalidEnumArgumentException

autoSizeRowMode 不是有效的 DataGridViewAutoSizeRowMode 值。

ArgumentOutOfRangeException

rowIndex 不在 0 到資料列數目減 1 的有效範圍內。

範例

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

void SizeThirdRow( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRow(2, DataGridViewAutoSizeRowMode::AllCellsExceptHeader);
}

private void SizeThirdRow(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRow(
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader);
}

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

    Dim thirdRow As Integer = 2
    DataGridView1.AutoResizeRow( _
        2, DataGridViewAutoSizeRowMode.AllCellsExceptHeader)

End Sub

備註

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

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

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

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

另請參閱

適用於

AutoResizeRow(Int32, DataGridViewAutoSizeRowMode, Boolean)

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

protected:
 void AutoResizeRow(int rowIndex, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRow (int rowIndex, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRow : int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRow (rowIndex As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)

參數

rowIndex
Int32

要調整大小之資料列的索引。

autoSizeRowMode
DataGridViewAutoSizeRowMode

其中一個 DataGridViewAutoSizeRowMode 值。

fixedWidth
Boolean

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

例外狀況

InvalidOperationException

autoSizeRowMode 具有值 RowHeader，且 RowHeadersVisible 為 false。

InvalidEnumArgumentException

autoSizeRowMode 不是有效的 DataGridViewAutoSizeRowMode 值。

ArgumentOutOfRangeException

rowIndex 不在 0 到資料列數目減 1 的有效範圍內。

備註

如果您想要控制資料列調整大小時，這個方法很有用。 每個方法呼叫的資料列高度只會調整一次;如果資料列的內容稍後變更，則資料列將不會自動調整。 若要調整所有資料列的大小，請使用 AutoResizeRows 方法。 若要將資料列設定為每當其內容變更時自動調整大小，請使用 AutoSizeRowsMode 屬性。

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

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

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

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

另請參閱

適用於