SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll, System.Data.SqlClient.dll

Pacchetto:: System.Data.SqlClient v4.8.6

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene in modo sincrono il valore della colonna specificata come tipo. GetFieldValue<T>(Int32) è la versione sincrona di questo metodo.

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)

Parametri di tipo

T

Tipo di valore da restituire.

Parametri

i: Int32

Colonna da recuperare.

cancellationToken: CancellationToken

L'istruzione di annullamento, che passa una notifica relativa alle operazioni che devono essere annullate. Ciò non garantisce l'annullamento. Impostazione di CancellationToken.None che rende questo metodo equivalente a IsDBNull(Int32). L'attività restituita deve essere contrassegnata come annullata.

Restituisce

Task<T>

Oggetto di tipo restituito.

Eccezioni

InvalidOperationException

La connessione viene eliminata o chiusa durante il richiamo dei dati.

SqlDataReader viene chiuso durante il richiamo dei dati.

Non sono disponibili dati pronti per essere letti (ad esempio, il primo Read() non è stato chiamato, o è stato restituito false).

Ha tentato di leggere una colonna letta in precedenza in modalità sequenziale.

Operazione asincrona in corso. Si applica a tutti i metodi Get* durante l'esecuzione in modalità sequenziale, in quanto possono essere chiamati durante la lettura di un flusso.

Context Connection=true è specificato nella stringa di connessione.

IndexOutOfRangeException

Tentativo di leggere una colonna che non esiste.

SqlNullValueException

Il valore della colonna era Null (IsDBNull(Int32) == true) nel recupero di un tipo non SQL.

InvalidCastException

T non corrisponde al tipo restituito da SQL Server o non è possibile eseguire il cast.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

T può essere uno dei tipi seguenti:


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	tipo CLR contrassegnato con SqlUserDefinedTypeAttribute.

Per altre informazioni, vedere Supporto per lo streaming sqlClient.

Si applica a

Condividi tramite