DataTableReader.GetName(Int32) Method

Definition

Gets the value of the specified column as a String.

public override string GetName (int ordinal);

Parameters

ordinal
Int32

The zero-based column ordinal.

Returns

The name of the specified column.

Exceptions

The index passed was outside the range of 0 to FieldCount - 1.

An attempt was made to read or access a column in a closed DataTableReader.

Examples

The following simple example includes a procedure that lists the names of all the columns within the specified DataTableReader, and the column's ordinal position, to the Console window.

private static void DisplayColumnNames(DataTableReader reader)
{
    // Given a DataTableReader, display column names.
    for (int i = 0; i < reader.FieldCount; i++)
    {
        Console.WriteLine("{0}: {1}", i, reader.GetName(i));
    }
}

Remarks

The GetName and GetOrdinal methods provide inverse functionality. That is, calling GetOrdinal on the return value of calling GetName should return the original parameter passed to GetName; the same applies to calling the procedures in the opposite order.

Applies to

Toode Versioonid
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1