SqlDataReader.GetFieldValue<T>(Int32) Método

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Obtém de forma síncrona o valor da coluna especificada como um tipo. GetFieldValueAsync<T>(Int32, CancellationToken) é a versão assíncrona deste método.

public:
generic <typename T>
 override T GetFieldValue(int i);
public override T GetFieldValue<T>(int i);
override this.GetFieldValue : int -> 'T
Public Overrides Function GetFieldValue(Of T) (i As Integer) As T

Parâmetros de tipo

T

O tipo do valor a ser retornado.

Parâmetros

i
Int32

A coluna a ser recuperada.

Retornos

T

O objeto de tipo retornado.

Exceções

InvalidOperationException

A conexão cai ou é fechada durante a recuperação de dados.

A SqlDataReader origem é fechada durante a recuperação de dados.

Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornado false).

Tentou ler uma coluna de leitura anterior no modo sequencial.

Havia uma operação assíncrona em andamento. Isso se aplica a todos os métodos Get* durante a execução no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.

IndexOutOfRangeException

Tentando ler uma coluna que não existe.

SqlNullValueException

O valor da coluna era nulo (IsDBNull(Int32) == true), recuperando um tipo não SQL.

InvalidCastException

T não corresponde ao tipo retornado por SQL Server ou não pode ser convertido.

Comentários

T pode ser um dos seguintes tipos:

Boolean, Byte, Char, DateTime, DateTimeOffset, Decimal, Double, Float, Guid, Int16, Int32, Int64, SqlBoolean, SqlByte, SqlDateTime, SqlDecimal, SqlDouble, SqlGuid, SqlInt16, SqlInt32, SqlInt64, SqlMoney, SqlSingle, SqlString, String ou UDT (qualquer tipo CLR marcado com SqlUserDefinedTypeAttribute).

Para obter mais informações, consulte o Suporte de Streaming do SqlClient.

Aplica-se a