DataTableReader.GetName(Int32) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataTableReader.cs

Obtém o valor da coluna especificada como um String.

public:
 override System::String ^ GetName(int ordinal);

public override string GetName (int ordinal);

override this.GetName : int -> string

Public Overrides Function GetName (ordinal As Integer) As String

Parâmetros

ordinal

Int32

O ordinal da coluna baseado em zero.

Retornos

String

O nome da coluna especificada.

Exceções

ArgumentOutOfRangeException

O índice passado estava fora do intervalo de 0 a FieldCount -1.

InvalidOperationException

Foi feita uma tentativa de ler ou acessar uma coluna em um DataTableReader fechado.

Exemplos

O exemplo simples a seguir inclui um procedimento que lista os nomes de todas as colunas dentro do especificado DataTableReadere a posição ordinal da coluna na janela Console.

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));
    }
}

Private Sub DisplayColumnNames(ByVal reader As DataTableReader)
   ' Given a DataTableReader, display column names.
   For i As Integer = 0 To reader.FieldCount - 1
      Console.WriteLine("{0}: {1}", i, reader.GetName(i))
   Next
End Sub

Comentários

Os GetName métodos e GetOrdinal fornecem funcionalidade inversa. Ou seja, chamar GetOrdinal no valor retornado da chamada GetName deve retornar o parâmetro original passado para GetName; o mesmo se aplica à chamada dos procedimentos na ordem oposta.