This documentation is archived and is not being maintained.

DataGridViewRow.GetState Method

Returns a value indicating the current state of the row.

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

public virtual DataGridViewElementStates GetState(
	int rowIndex
)

Parameters

rowIndex
Type: System.Int32
The index of the row.

Return Value

Type: System.Windows.Forms.DataGridViewElementStates
A bitwise combination of DataGridViewElementStates values indicating the row state.

ExceptionCondition
ArgumentOutOfRangeException

The row has been added to a DataGridView control, but the rowIndex value is not in the valid range of 0 to the number of rows in the control minus 1.

ArgumentException

The row is not a shared row, but the rowIndex value does not match the row's Index property value.

-or-

The row has not been added to a DataGridView control, but the rowIndex value does not match the row's Index property value.

This method is useful to determine the state of a shared row. Shared rows have Index values of -1, which prevents you from using the State property with shared rows. To use this method, pass in the actual row index. You can retrieve the actual index of a shared row by calling the IndexOf method.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: