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.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: