DataGridView.AutoResizeColumns Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Passt die Breite aller Spalten an den Inhalt ihrer Zellen an.

Überlädt

AutoResizeColumns()	Passt die Breite aller Spalten an den Inhalt ihrer Zellen einschließlich der Headerzellen an.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode)	Passt die Breite aller Spalten im angegebenen Größenmodus an.
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)	Passt die Breite aller Spalten im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Breite unter der Annahme, dass die jeweilige Zeilenhöhe anschließend angepasst wird.

AutoResizeColumns()

Passt die Breite aller Spalten an den Inhalt ihrer Zellen einschließlich der Headerzellen an.

public:
 void AutoResizeColumns();

public void AutoResizeColumns ();

member this.AutoResizeColumns : unit -> unit

Public Sub AutoResizeColumns ()

Beispiele

Im folgenden Codebeispiel werden alle Spalten so angepasst, dass sie an den Inhalt der Spalten und die Spaltenüberschriften angepasst werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in How to: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement bereitgestellt wird.

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

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

• DataGridView-Steuerelement (Windows Forms)

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

Passt die Breite aller Spalten im angegebenen Größenmodus an.

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)

Parameter

autoSizeColumnsMode

DataGridViewAutoSizeColumnsMode

Einer der DataGridViewAutoSizeColumnsMode-Werte.

Ausnahmen

InvalidOperationException

autoSizeColumnsMode hat den Wert ColumnHeader, und ColumnHeadersVisible ist false.

ArgumentException

autoSizeColumnsMode hat den Wert None oder Fill.

InvalidEnumArgumentException

autoSizeColumnsMode ist kein gültiger DataGridViewAutoSizeColumnsMode-Wert.

Beispiele

Im folgenden Codebeispiel werden alle Spalten so angepasst, dass sie an den Inhalt der Spalten und die Spaltenüberschriften angepasst werden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in How to: Programmgesteuertes Ändern der Größe von Zellen zum Anpassen von Inhalten im Windows Forms DataGridView-Steuerelement bereitgestellt wird.

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

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.

Mit dieser Überladung können Sie einen Größenmodus angeben, der die neuen Breiten basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

• DataGridView-Steuerelement (Windows Forms)

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

Passt die Breite aller Spalten im angegebenen Größenänderungsmodus an und berechnet optional die jeweilige Breite unter der Annahme, dass die jeweilige Zeilenhöhe anschließend angepasst wird.

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)

Parameter

autoSizeColumnsMode

DataGridViewAutoSizeColumnsMode

Einer der DataGridViewAutoSizeColumnsMode-Werte.

fixedHeight

Boolean

true, um die jeweils neue Breite auf Grundlage der aktuellen Zeilenhöhe zu berechnen, false, um die Breite unter der Annahme zu berechnen, dass die jeweilige Zeilenhöhe ebenfalls angepasst wird.

Ausnahmen

InvalidOperationException

autoSizeColumnsMode hat den Wert ColumnHeader, und ColumnHeadersVisible ist false.

ArgumentException

autoSizeColumnsMode hat den Wert None oder Fill.

InvalidEnumArgumentException

autoSizeColumnsMode ist kein gültiger DataGridViewAutoSizeColumnsMode-Wert.

Hinweise

Diese Methode ist nützlich, wenn Sie steuern möchten, wann Spalten die Größe ändern. Die Spaltenbreiten werden nur einmal pro Methodenaufruf angepasst; Wenn sich der Inhalt der Spalten später ändert, werden die Spalten nicht automatisch angepasst. Verwenden Sie die Methode, um die AutoResizeColumn Größe einer bestimmten Spalte zu ändern. Verwenden Sie die Eigenschaft oder die AutoSizeColumnsMode Spalteneigenschaft AutoSizeMode , um die Größe automatisch zu ändern, wenn sich der Inhalt ändert.

Mit dieser Überladung können Sie einen Größenmodus angeben, der die neuen Breiten basierend auf Werten in einer begrenzten Gruppe von Zellen berechnet, z. B. nur in angezeigten Zeilen. Dadurch wird die Leistung verbessert, wenn das Steuerelement eine große Anzahl von Zeilen enthält.

Diese Überladung ist geschützt und ist so konzipiert, dass Sie ideale Zellhöhen-zu-Breite-Verhältnis in einer abgeleiteten DataGridView Klasse erzielen können. Wenn fixedHeight ja false, werden die Spaltenbreiten mit der Erwartung berechnet, dass Sie die AutoResizeRow Methode AutoResizeRows als nächstes aufrufen.

Weitere Informationen zur programmgesteuerten Größenänderung finden Sie unter Sizing Options in the Windows Forms DataGridView Control.

Siehe auch

• DataGridView-Steuerelement (Windows Forms)