SqlDataReader.GetFieldValue<T>(Int32) 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

지정된 열의 값을 형식으로 동기적으로 가져옵니다. GetFieldValueAsync<T>(Int32, CancellationToken)은 이 메서드의 비동기 버전입니다.

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

형식 매개 변수

T

반환될 값의 형식입니다.

매개 변수

i

Int32

검색할 열입니다.

반환

T

반환된 형식 개체입니다.

예외

InvalidOperationException

데이터 검색 중 연결이 끊기거나 닫힌 경우

데이터 검색 중 SqlDataReader가 닫힌 경우

읽을 준비가 된 데이터가 없는 경우(예를 들어, 첫 번째 Read()가 호출되지 않았거나 false를 반환한 경우)

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.

진행 중인 비동기 작업이 없습니다. 이는 스트림을 읽는 동안 호출할 수 있기 때문에 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.

IndexOutOfRangeException

존재하지 않는 열을 읽으려고 시도합니다.

SqlNullValueException

열의 값이 SQL이 아닌 형식을 검색하는 null(IsDBNull(Int32) == true)인 경우

InvalidCastException

T는 SQL Server에서 반환되는 형식과 일치하지 않거나 캐스팅할 수 없습니다.

설명

T 는 다음 형식 중 하나일 수 있습니다.

부울	Byte	Char	DateOnly(.NET 6 이상)
DateTime	DateTimeOffset	Decimal	Double
Float	GUID	Int16	Int32
Int64	SqlBoolean	SqlByte	SqlDateTime
SqlDecimal	SqlDouble	SqlGuid	SqlInt16
SqlInt32	SqlInt64	SqlMoney	SqlSingle
SqlString	STREAM	String	TextReader
TimeOnly(.NET 6 이상)	XmlReader		UDT- 로 표시된 SqlUserDefinedTypeAttributeCLR 형식일 수 있습니다.

자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.