SqlDataReader.ReadAsync(CancellationToken) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Asynchroniczna wersja programu Read(), która przechodzi SqlDataReader do następnego rekordu.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

public:
 override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<Boolean>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie ReadAsync(CancellationToken) więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

Uwagi

behavior Jeśli parametr parametru ExecuteReaderAsync ma wartość Default, ReadAsync odczytuje cały wiersz przed zwróceniem zadania.

Aby uzyskać więcej informacji, w tym przykłady kodu, dotyczące programowania asynchronicznego w dostawcy danych .NET Framework dla SQL Server, zobacz Programowanie asynchroniczne.

Uwaga

Podczas odczytywania dużych danych (binarnych/tekstowych) zaleca się użycie Read w celu uzyskania optymalnej wydajności.