SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Metodo
Definizione
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 asincrono 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 del valore da restituire.
Parametri
- i
- Int32
Colonna da recuperare.
- cancellationToken
- CancellationToken
Istruzione di annullamento, che propaga una notifica che le operazioni devono essere annullate. Ciò non garantisce l'annullamento. Un'impostazione di CancellationToken.None rende questo metodo equivalente a IsDBNull(Int32). L'attività restituita deve essere contrassegnata come annullata.
Valori restituiti
Oggetto di tipo restituito.
Eccezioni
La connessione viene eliminata o chiusa durante il recupero dei dati.
L'oggetto SqlDataReader viene chiuso durante il recupero dei dati.
Non sono disponibili dati pronti per la lettura(ad esempio, il primo Read() non è stato chiamato o restituito false).
Si è tentato di leggere una colonna di lettura precedente in modalità sequenziale.
È in corso un'operazione asincrona. Questo vale per tutti i metodi Get* durante l'esecuzione in modalità sequenziale, perché possono essere chiamati durante la lettura di un flusso.
Context Connection=true viene specificato nel stringa di connessione.
Tentativo di leggere una colonna che non esiste.
Il valore della colonna è null (IsDBNull(Int32) == true), recuperando un tipo non SQL.
T non corrisponde al tipo restituito da SQL Server o non può essere eseguito il cast.
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 o UDT (qualsiasi tipo CLR contrassegnato con SqlUserDefinedTypeAttribute).
Per altre informazioni, vedere Supporto per lo streaming sqlClient.