DataGridView.AutoResizeColumns Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Ajusta el ancho de todas las columnas para adaptarlo al contenido de sus celdas.

Sobrecargas

AutoResizeColumns()	Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)	Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)	Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas.

AutoResizeColumns()

Ajusta el ancho de todas las columnas para adaptarlo al contenido de todas sus celdas, incluidas las celdas de encabezado.

public:
 void AutoResizeColumns();

public void AutoResizeColumns ();

member this.AutoResizeColumns : unit -> unit

Public Sub AutoResizeColumns ()

Ejemplos

En el ejemplo de código siguiente se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de columna. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Ajusta el ancho de todas las columnas utilizando el modo de ajuste de tamaño especificado.

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)

Parámetros

autoSizeColumnsMode

DataGridViewAutoSizeColumnsMode

Uno de los valores de DataGridViewAutoSizeColumnsMode.

Excepciones

InvalidOperationException

autoSizeColumnsMode tiene el valor ColumnHeader y ColumnHeadersVisible es false.

ArgumentException

autoSizeColumnsMode tiene el valor None o Fill.

InvalidEnumArgumentException

autoSizeColumnsMode no es un valor DataGridViewAutoSizeColumnsMode válido.

Ejemplos

En el ejemplo de código siguiente se cambia el tamaño de todas las columnas para ajustarse al contenido de las columnas y los encabezados de columna. Este ejemplo de código forma parte de un ejemplo más grande proporcionado en How to: Programmatically Resize Cells to Fit Content in the Windows Forms DataGridView Control.

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

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .

Esta sobrecarga le permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos en función de los valores de un conjunto limitado de celdas, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Ajusta el ancho de todas las columnas usando el modo de ajuste de tamaño especificado y, opcionalmente, calcula el ancho con la expectativa de que se ajuste a continuación el alto de las filas.

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)

Parámetros

autoSizeColumnsMode

DataGridViewAutoSizeColumnsMode

Uno de los valores de DataGridViewAutoSizeColumnsMode.

fixedHeight

Boolean

Es true para calcular los nuevos anchos a partir del alto actual de las filas; es false para calcular los anchos de forma que también se ajuste el alto de las filas.

Excepciones

InvalidOperationException

autoSizeColumnsMode tiene el valor ColumnHeader y ColumnHeadersVisible es false.

ArgumentException

autoSizeColumnsMode tiene el valor None o Fill.

InvalidEnumArgumentException

autoSizeColumnsMode no es un valor DataGridViewAutoSizeColumnsMode válido.

Comentarios

Este método es útil si desea controlar cuándo cambian el tamaño de las columnas. Los anchos de columna se ajustan una sola vez por llamada al método; si el contenido de las columnas cambia más adelante, las columnas no se ajustarán automáticamente. Para cambiar el tamaño de una columna específica, use el AutoResizeColumn método . Para establecer que las columnas cambien automáticamente el tamaño siempre que cambie su contenido, utilice la AutoSizeColumnsMode propiedad o la propiedad de columna AutoSizeMode .

Esta sobrecarga le permite especificar un modo de ajuste de tamaño que calcula los nuevos anchos en función de los valores de un conjunto limitado de celdas, como los de las filas mostradas únicamente. Esto mejora el rendimiento cuando el control contiene un gran número de filas.

Esta sobrecarga está protegida y está diseñada para permitirle lograr relaciones ideales de alto a ancho de celda en una clase derivada DataGridView . Si fixedHeight es false, los anchos de columna se calcularán con la expectativa de llamar al AutoResizeRow método o AutoResizeRows a continuación.

Para obtener más información sobre el cambio de tamaño mediante programación, vea Opciones de ajuste de tamaño en el control DataGridView de Windows Forms.

Consulte también

• DataGridView (Control, formularios Windows Forms)