Export (0) Print
Expand All

DataTableReader.Item Property (String)

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)

abstract Item : 
        name:string -> Object with get 
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

ExceptionCondition
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.

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 Item corresponds to calling the 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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft