SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Metódus

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Aszinkron módon típusként kapja meg a megadott oszlop értékét. GetFieldValue<T>(Int32) A metódus szinkron verziója.

public:
generic <typename T>
 override System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int i, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int i, System.Threading.CancellationToken cancellationToken);

override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overrides Function GetFieldValueAsync(Of T) (i As Integer, cancellationToken As CancellationToken) As Task(Of T)

Típusparaméterek

T

A visszaadandó érték típusa.

Paraméterek

i

Int32

A lekérendő oszlop.

cancellationToken

CancellationToken

A lemondási utasítás, amely egy értesítést küld arról, hogy a műveleteket le kell mondani. Ez nem garantálja a lemondást. A beállítás ezt a CancellationToken.None metódust egyenértékűvé teszi a következővel IsDBNull(Int32): . A visszaadott feladatot megszakítottként kell megjelölni.

Válaszok

Task<T>

A visszaadott típusobjektum.

Kivételek

InvalidOperationException

A kapcsolat megszakad vagy le van zárva az adatlekérés során.

Az SqlDataReader adatlekérés során a rendszer bezárja a elemet.

Nincs olvasásra kész adat (például az első Read() nem lett meghívva, vagy hamis értéket ad vissza).

Megpróbált beolvasni egy korábban beolvasott oszlopot szekvenciális módban.

Aszinkron művelet volt folyamatban. Ez az összes Get* metódusra vonatkozik, ha szekvenciális módban futnak, mivel a stream olvasása közben meghívhatók.

Context Connection=true a kapcsolati karakterlánc van megadva.

IndexOutOfRangeException

Nem létező oszlop olvasása.

SqlNullValueException

Az oszlop értéke null (IsDBNull(Int32) == true, nem SQL-típus beolvasása).

InvalidCastException

T nem egyezik a SQL Server által visszaadott típussal, vagy nem lehet leadni.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

T az alábbi típusok egyike lehet:

Logikai, Byte, Char, DateTime, DateTimeOffset, Decimális, Dupla, Lebegőpontos, Guid, Int16, Int32, Int64, SqlBoolean, SqlByte, SqlDateTime, SqlDecimal, SqlDouble, SqlGuid, SqlInt16, SqlInt32, SqlInt64, SqlMoney, SqlSingle, SqlString, String vagy UDT (bármely CLR-típus).SqlUserDefinedTypeAttribute

További információ: SqlClient Streaming Support.