IndexOf(String,Boolean) Method

In This Topic

Gets the index of the Column with the specified name, optionally throwing an exception if the column is not found.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function IndexOf( _
   ByVal columnName As String, _
   ByVal throwIfNotFound As Boolean _
) As Integer

public int IndexOf( 
   string columnName,
   bool throwIfNotFound
)

Parameters

columnName: Column name to look for (case-insensitive).
throwIfNotFound: Whether to throw and exception if the column cannot be found.

Return Value

Index of the column that has the given name in this collection, or -1 if the collection does not contain a column with the given name.

Remarks

If the parameter is set to true and a column named cannot be found, the control throws an System.ArgumentOutOfRangeException. This makes it easier to write compact code that relies on column names.

Example

The example below uses the IndexOf method to convert column names into indices. Note that if the column names are invalid, the exception will be thrown by the IndexOf method (column not found) rather than in the following method, where it would not be as clear (invalid index).

int columnIndex = _flex.Cols.IndexOf("total");
_flex.AutoSizeCol(columnIndex);

Reference

ColumnCollection Class
ColumnCollection Members
Overload List