DataGridViewRow.Frozen Property

 

Gets or sets a value indicating whether the row is frozen.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public override bool Frozen { get; set; }

Property Value

Type: System.Boolean

true if the row is frozen; otherwise, false.

Exception Condition
InvalidOperationException

The row is in a DataGridView control and is a shared row.

This property lets you keep one or several rows of important information in place when a user scrolls through the DataGridView. All rows above the frozen row are also frozen.

The following code example demonstrates how to use the DataGridViewBand.Frozen property, which is nearly identical to the Frozen property of the DataGridViewRow class. This code example is part of a larger example provided for the DataGridViewBand class.

// Freeze the first row.
private void Button4_Click(object sender, System.EventArgs e)
{

    FreezeBand(dataGridView.Rows[0]);
}

private void Button5_Click(object sender, System.EventArgs e)
{

    FreezeBand(dataGridView.Columns[1]);
}

private static void FreezeBand(DataGridViewBand band)
{
    band.Frozen = true;
    DataGridViewCellStyle style = new DataGridViewCellStyle();
    style.BackColor = Color.WhiteSmoke;
    band.DefaultCellStyle = style;
}

.NET Framework
Available since 2.0
Return to top
Show: