DataTableReader.Item Property (String)

.NET Framework (current version)

Note
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the value of the specified column in its native format given the column name.

Namespace: System.Data
Assembly: System.Data (in System.Data.dll)

Syntax

C++

override Item : 
        name:string -> Object with get

Parameters

name: Type: System.String
The name of the column.

Property Value

Type: System.Object

The value of the specified column in its native format.

Implements

IDataRecord.Item(String)

Exceptions

Exception	Condition
ArgumentException	The name specified is not a valid column name.
DeletedRowInaccessibleException	An attempt was made to retrieve data from a deleted row.
InvalidOperationException	An attempt was made to read or access a column in a closed DataTableReader.

Remarks

A case-sensitive lookup is performed first. If it fails, a second case-insensitive search is made.

This method is kana-width insensitive.

This overloaded version of M:System.Data.DataTableReader.Item corresponds to calling the M:System.Data.DataTableReader.GetOrdinal method, and then subsequently calling the GetValue method.

Given a DataTableReader and a column name, the GetValueByName procedure returns the value of the specified column. Before calling this procedure, you must create a new DataTableReader instance and call its Read method at least one time to position the row pointer on a row of data.

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0